buildroot.git/docs/manual/makedev-syntax.txt, branch master

makedevs: add capability support

2016-06-30T10:13:38+00:00

Add the support of capability to makedevs as extended attribute. Now, it's possible to add a line "|xattr " after a file description to also add a capability to this file. It's possible to add severals capabilities with severals lines. [Peter: extend doc, reword Config.in, extend error message, use HOST_MAKEDEVS_CFLAGS/LDFLAGS for all flags] Signed-off-by: Philippe Reynes Signed-off-by: Peter Korsgaard

docs: Fixed syntax error in makedev-syntax example.

2016-05-23T20:44:22+00:00

In the makedev syntax documentation, one of the examples lacks the "mode" value. This patch fixes that example. Signed-off-by: Alan Yaniger Acked-by: "Yann E. MORIN" Signed-off-by: Peter Korsgaard

docs/manual: makedev syntax accepts usernames and group names

2016-02-01T07:02:38+00:00

Signed-off-by: "Yann E. MORIN" Cc: Thomas Petazzoni Signed-off-by: Peter Korsgaard

docs/manual: makedevs only accepts numerical values

2015-08-29T08:35:28+00:00

Because of a limitation in how makedevs resolves names [0], usernames and groupnames would be resolved with UIDs and GIDs from the host, not the target. Fixing makedevs would involve us rewriting a /etc/passwd and /etc/group parser (not too complex, still not trivial). Document that the user and group fields should only be numbers, not names. Also, the manual is currently misleading, as an example indeed uses names for the user and group fields. Fix that and expand the explanations. The mode field should also be numbers, not a rwx combo. Slight typographical eye-candy about major/minor fields. [0] it uses getpwnma(3) and getgrnam(3) to resolve names to IDs, and those only resolve names on the host (i.e. there is no way to specify a chroot-like feature) Signed-off-by: "Yann E. MORIN" Signed-off-by: Thomas Petazzoni

docs/manual: documentation for recursive makedevs syntax

2015-04-11T16:03:25+00:00

This patch adds the documentation for the new makedevs recursive syntax. [Thomas: s/folder/directory/ as suggested by Yann.] Signed-off-by: Angelo Compagnucci Reviewed-by: "Yann E. MORIN" Signed-off-by: Thomas Petazzoni

manual: Rework makedevs syntax

2014-11-22T19:12:38+00:00

State that it should be a space separated list and fix the example. Also reduce the number of dash used to 4. [Thomas: replace tab by space, as noted by Yann.] Signed-off-by: Maxime Hadjinlian Signed-off-by: Thomas Petazzoni

manual: use one-line titles instead of two-line titles (trivial)

2014-05-02T08:27:59+00:00

Asciidoc supports two syntaxes for section titles: two-line titles (title plus underline consisting of a particular symbol), and one-line titles (title prefixed with a specific number of = signs). The two-line title underlines are: Level 0 (top level): ====================== Level 1: ---------------------- Level 2: ~~~~~~~~~~~~~~~~~~~~~~ Level 3: ^^^^^^^^^^^^^^^^^^^^^^ Level 4 (bottom level): ++++++++++++++++++++++ and the one-line title prefixes: = Document Title (level 0) = == Section title (level 1) == === Section title (level 2) === ==== Section title (level 3) ==== ===== Section title (level 4) ===== The buildroot manual is currenly using the two-line titles, but this has multiple disadvantages: - asciidoc also uses some of the underline symbols for other purposes (like preformatted code, example blocks, ...), which makes it difficult to do mass replacements, such as a planned follow-up patch that needs to move all sections one level down. - it is difficult to remember which level a given underline symbol (=-~^+) corresponds to, while counting = signs is easy. This patch changes all two-level titles to one-level titles in the manual. The bulk of the change was done with the following Python script, except for the level 1 titles (-----) as these underlines are also used for literal code blocks. This patch only changes the titles, no other changes. In adding-packages-directory.txt, I did add missing newlines between some titles and their content. ---------------------------------------------------------------------------- #!/usr/bin/env python import sys import mmap import re for input in sys.argv[1:]: f = open(input, 'r+') f.flush() s = mmap.mmap(f.fileno(), 0) # Level 0 (top level): ====================== = # Level 1: ---------------------- == # Level 2: ~~~~~~~~~~~~~~~~~~~~~~ === # Level 3: ^^^^^^^^^^^^^^^^^^^^^^ ==== # Level 4 (bottom level): ++++++++++++++++++++++ ===== def replace_title(s, symbol, replacement): pattern = re.compile(r'(.+\n)\%s{2,}\n' % symbol, re.MULTILINE) return pattern.sub(r'%s \1' % replacement, s) new = s new = replace_title(new, '=', '=') new = replace_title(new, '+', '=====') new = replace_title(new, '^', '====') new = replace_title(new, '~', '===') #new = replace_title(new, '-', '==') s.seek(0) s.write(new) s.resize(s.tell()) s.close() f.close() ---------------------------------------------------------------------------- Signed-off-by: Thomas De Schampheleire Signed-off-by: Peter Korsgaard

manual: cleanup and update editor tags

2013-02-17T21:50:04+00:00

Signed-off-by: Samuel Martin Acked-by: Arnout Vandecappelle (Essensium/Mind) Signed-off-by: Peter Korsgaard

manual: various fixes

2012-11-28T01:07:42+00:00

Various consistency and correctness improvements. Also removing some sentences that are not or no longer relevant. Signed-off-by: Arnout Vandecappelle (Essensium/Mind) Acked-by: Samuel Martin Signed-off-by: Peter Korsgaard

manual: trivial fixes

2012-11-28T01:07:39+00:00

Signed-off-by: Arnout Vandecappelle (Essensium/Mind) Signed-off-by: Peter Korsgaard