@@ -2857,11 +2857,11 @@ <h2 id="options-21"><a class="header" href="#options-21">Options</a></h2>
28572857</ dd >
28582858< dt > < code > --dereference-command-line-symlink-to-dir</ code > </ dt >
28592859< dd >
2860- < p > Do not dereference symlinks except when they link to directories and are given as command line arguments.</ p >
2860+ < p > Do not follow symlinks except when they link to directories and are given as command line arguments.</ p >
28612861</ dd >
28622862< dt > < code > --dereference-command-line</ code > , < code > -H</ code > </ dt >
28632863< dd >
2864- < p > Do not dereference symlinks except when given as command line arguments.</ p >
2864+ < p > Do not follow symlinks except when given as command line arguments.</ p >
28652865</ dd >
28662866< dt > < code > --no-group</ code > , < code > -G</ code > </ dt >
28672867< dd >
@@ -3156,11 +3156,11 @@ <h2 id="options-24"><a class="header" href="#options-24">Options</a></h2>
31563156</ dd >
31573157< dt > < code > --dereference</ code > , < code > -L</ code > </ dt >
31583158< dd >
3159- < p > dereference all symbolic links</ p >
3159+ < p > follow all symbolic links</ p >
31603160</ dd >
31613161< dt > < code > --dereference-args</ code > , < code > -D</ code > </ dt >
31623162< dd >
3163- < p > dereference only symlinks that are listed on the command line</ p >
3163+ < p > follow only symlinks that are listed on the command line</ p >
31643164</ dd >
31653165< dt > < code > -m</ code > </ dt >
31663166< dd >
@@ -3556,17 +3556,21 @@ <h2 id="examples-27"><a class="header" href="#examples-27">Examples</a></h2>
35563556< div class ="version "> v0.0.18
35573557</ div >
35583558</ div >
3559- < pre > < code > factor [NUMBER]...
3559+ < pre > < code > factor [OPTION]... [ NUMBER]...
35603560</ code > </ pre >
35613561< p > Print the prime factors of the given NUMBER(s).
35623562If none are specified, read from standard input.</ p >
35633563< h2 id ="options-29 "> < a class ="header " href ="#options-29 "> Options</ a > </ h2 >
35643564< dl > < dt > </ dt >
35653565< dd >
35663566</ dd >
3567- < dt > < code > --help </ code > , < code > -h</ code > </ dt >
3567+ < dt > < code > --exponents </ code > , < code > -h</ code > </ dt >
35683568< dd >
3569- < p > Print help</ p >
3569+ < p > Print factors in the form p^e</ p >
3570+ </ dd >
3571+ < dt > < code > --help</ code > </ dt >
3572+ < dd >
3573+ < p > Print help information.</ p >
35703574</ dd >
35713575< dt > < code > --version</ code > , < code > -V</ code > </ dt >
35723576< dd >
@@ -4536,7 +4540,7 @@ <h2 id="options-43"><a class="header" href="#options-43">Options</a></h2>
45364540</ dd >
45374541< dt > < code > --logical</ code > , < code > -L</ code > </ dt >
45384542< dd >
4539- < p > dereference TARGETs that are symbolic links</ p >
4543+ < p > follow TARGETs that are symbolic links</ p >
45404544</ dd >
45414545< dt > < code > --physical</ code > , < code > -P</ code > </ dt >
45424546< dd >
@@ -4774,11 +4778,11 @@ <h2 id="options-45"><a class="header" href="#options-45">Options</a></h2>
47744778</ dd >
47754779< dt > < code > --dereference-command-line-symlink-to-dir</ code > </ dt >
47764780< dd >
4777- < p > Do not dereference symlinks except when they link to directories and are given as command line arguments.</ p >
4781+ < p > Do not follow symlinks except when they link to directories and are given as command line arguments.</ p >
47784782</ dd >
47794783< dt > < code > --dereference-command-line</ code > , < code > -H</ code > </ dt >
47804784< dd >
4781- < p > Do not dereference symlinks except when given as command line arguments.</ p >
4785+ < p > Do not follow symlinks except when given as command line arguments.</ p >
47824786</ dd >
47834787< dt > < code > --no-group</ code > , < code > -G</ code > </ dt >
47844788< dd >
@@ -6338,179 +6342,10 @@ <h2 id="options-64"><a class="header" href="#options-64">Options</a></h2>
63386342< p > prints format string at least once, repeating as long as there are remaining arguments
63396343output prints escaped literals in the format string as character literals
63406344output replaces anonymous fields with the next unused argument, formatted according to the field.</ p >
6341- < p > Prints the , replacing escaped character sequences with character literals
6345+ < p > Prints the < code > , </ code > replacing escaped character sequences with character literals
63426346and substitution field sequences with passed arguments</ p >
63436347< p > literally, with the exception of the below
63446348escaped character sequences, and the substitution sequences described further down.</ p >
6345- < p > ESCAPE SEQUENCES</ p >
6346- < p > The following escape sequences, organized here in alphabetical order,
6347- will print the corresponding character literal:</ p >
6348- < p > " double quote</ p >
6349- < p > \ backslash</ p >
6350- < p > \a alert (BEL)</ p >
6351- < p > \b backspace</ p >
6352- < p > \c End-of-Input</ p >
6353- < p > \e escape</ p >
6354- < p > \f form feed</ p >
6355- < p > \n new line</ p >
6356- < p > \r carriage return</ p >
6357- < p > \t horizontal tab</ p >
6358- < p > \v vertical tab</ p >
6359- < p > \NNN byte with value expressed in octal value NNN (1 to 3 digits)
6360- values greater than 256 will be treated</ p >
6361- < p > \xHH byte with value expressed in hexadecimal value NN (1 to 2 digits)</ p >
6362- < p > \uHHHH Unicode (IEC 10646) character with value expressed in hexadecimal value HHHH (4 digits)</ p >
6363- < p > \uHHHH Unicode character with value expressed in hexadecimal value HHHH (8 digits)</ p >
6364- < p > %% a single %</ p >
6365- < p > SUBSTITUTIONS</ p >
6366- < p > SUBSTITUTION QUICK REFERENCE</ p >
6367- < p > Fields</ p >
6368- < p > %s - string
6369- %b - string parsed for literals
6370- second parameter is max length</ p >
6371- < p > %c - char
6372- no second parameter</ p >
6373- < p > %i or %d - 64-bit integer
6374- %u - 64 bit unsigned integer
6375- %x or %X - 64-bit unsigned integer as hex
6376- %o - 64-bit unsigned integer as octal
6377- second parameter is min-width, integer
6378- output below that width is padded with leading zeroes</ p >
6379- < p > %f or %F - decimal floating point value
6380- %e or %E - scientific notation floating point value
6381- %g or %G - shorter of specially interpreted decimal or SciNote floating point value.
6382- second parameter is
6383- -max places after decimal point for floating point output
6384- -max number of significant digits for scientific notation output</ p >
6385- < p > parameterizing fields</ p >
6386- < p > examples:</ p >
6387- < p > printf '%4.3i' 7
6388- has a first parameter of 4
6389- and a second parameter of 3
6390- will result in ' 007'</ p >
6391- < p > printf '%.1s' abcde
6392- has no first parameter
6393- and a second parameter of 1
6394- will result in 'a'</ p >
6395- < p > printf '%4c' q
6396- has a first parameter of 4
6397- and no second parameter
6398- will result in ' q'</ p >
6399- < p > The first parameter of a field is the minimum width to pad the output to
6400- if the output is less than this absolute value of this width,
6401- it will be padded with leading spaces, or, if the argument is negative,
6402- with trailing spaces. the default is zero.</ p >
6403- < p > The second parameter of a field is particular to the output field type.
6404- defaults can be found in the full substitution help below</ p >
6405- < p > special prefixes to numeric arguments
6406- 0 (e.g. 010) - interpret argument as octal (integer output fields only)
6407- 0x (e.g. 0xABC) - interpret argument as hex (numeric output fields only)
6408- ' (e.g. 'a) - interpret argument as a character constant</ p >
6409- < p > HOW TO USE SUBSTITUTIONS</ p >
6410- < p > Substitutions are used to pass additional argument(s) into the FORMAT string, to be formatted a
6411- particular way. E.g.</ p >
6412- < pre > < code > printf 'the letter %X comes before the letter %X' 10 11
6413- </ code > </ pre >
6414- < p > will print</ p >
6415- < p > 'the letter A comes before the letter B'</ p >
6416- < p > because the substitution field %X means
6417- 'take an integer argument and write it as a hexadecimal number'</ p >
6418- < p > Passing more arguments than are in the format string will cause the format string to be
6419- repeated for the remaining substitutions</ p >
6420- < p > printf 'it is %i F in %s
6421- ' 22 Portland 25 Boston 27 New York</ p >
6422- < p > will print</ p >
6423- < p > 'it is 22 F in Portland
6424- it is 25 F in Boston
6425- it is 27 F in Boston
6426- '
6427- If a format string is printed but there are less arguments remaining
6428- than there are substitution fields, substitution fields without
6429- an argument will default to empty strings, or for numeric fields
6430- the value 0</ p >
6431- < p > AVAILABLE SUBSTITUTIONS</ p >
6432- < p > This program, like GNU coreutils printf,
6433- interprets a modified subset of the POSIX C printf spec,
6434- a quick reference to substitutions is below.</ p >
6435- < p > STRING SUBSTITUTIONS
6436- All string fields have a 'max width' parameter
6437- %.3s means 'print no more than three characters of the original input'</ p >
6438- < p > %s - string</ p >
6439- < p > %b - escaped string - the string will be checked for any escaped literals from
6440- the escaped literal list above, and translate them to literal characters.
6441- e.g. \n will be transformed into a newline character.</ p >
6442- < pre > < code > One special rule about %b mode is that octal literals are interpreted differently
6443- In arguments passed by %b, pass octal-interpreted literals must be in the form of \0NNN
6444- instead of \NNN. (Although, for legacy reasons, octal literals in the form of \NNN will
6445- still be interpreted and not throw a warning, you will have problems if you use this for a
6446- literal whose code begins with zero, as it will be viewed as in \0NNN form.)
6447- </ code > </ pre >
6448- < p > CHAR SUBSTITUTIONS
6449- The character field does not have a secondary parameter.</ p >
6450- < p > %c - a single character</ p >
6451- < p > INTEGER SUBSTITUTIONS
6452- All integer fields have a 'pad with zero' parameter
6453- %.4i means an integer which if it is less than 4 digits in length,
6454- is padded with leading zeros until it is 4 digits in length.</ p >
6455- < p > %d or %i - 64-bit integer</ p >
6456- < p > %u - 64 bit unsigned integer</ p >
6457- < p > %x or %X - 64 bit unsigned integer printed in Hexadecimal (base 16)
6458- %X instead of %x means to use uppercase letters for 'a' through 'f'</ p >
6459- < p > %o - 64 bit unsigned integer printed in octal (base 8)</ p >
6460- < p > FLOATING POINT SUBSTITUTIONS</ p >
6461- < p > All floating point fields have a 'max decimal places / max significant digits' parameter
6462- %.10f means a decimal floating point with 7 decimal places past 0
6463- %.10e means a scientific notation number with 10 significant digits
6464- %.10g means the same behavior for decimal and Sci. Note, respectively, and provides the shorter
6465- of each's output.</ p >
6466- < p > Like with GNU coreutils, the value after the decimal point is these outputs is parsed as a
6467- double first before being rendered to text. For both implementations do not expect meaningful
6468- precision past the 18th decimal place. When using a number of decimal places that is 18 or
6469- higher, you can expect variation in output between GNU coreutils printf and this printf at the
6470- 18th decimal place of +/- 1</ p >
6471- < p > %f - floating point value presented in decimal, truncated and displayed to 6 decimal places by
6472- default. There is not past-double behavior parity with Coreutils printf, values are not
6473- estimated or adjusted beyond input values.</ p >
6474- < p > %e or %E - floating point value presented in scientific notation
6475- 7 significant digits by default
6476- %E means use to use uppercase E for the mantissa.</ p >
6477- < p > %g or %G - floating point value presented in the shorter of decimal and scientific notation
6478- behaves differently from %f and %E, please see posix printf spec for full details,
6479- some examples of different behavior:</ p >
6480- < pre > < code > Sci Note has 6 significant digits by default
6481- Trailing zeroes are removed
6482- Instead of being truncated, digit after last is rounded
6483- </ code > </ pre >
6484- < p > Like other behavior in this utility, the design choices of floating point
6485- behavior in this utility is selected to reproduce in exact
6486- the behavior of GNU coreutils' printf from an inputs and outputs standpoint.</ p >
6487- < p > USING PARAMETERS
6488- Most substitution fields can be parameterized using up to 2 numbers that can
6489- be passed to the field, between the % sign and the field letter.</ p >
6490- < p > The 1st parameter always indicates the minimum width of output, it is useful for creating
6491- columnar output. Any output that would be less than this minimum width is padded with
6492- leading spaces
6493- The 2nd parameter is proceeded by a dot.
6494- You do not have to use parameters</ p >
6495- < p > SPECIAL FORMS OF INPUT
6496- For numeric input, the following additional forms of input are accepted besides decimal:</ p >
6497- < p > Octal (only with integer): if the argument begins with a 0 the proceeding characters
6498- will be interpreted as octal (base 8) for integer fields</ p >
6499- < p > Hexadecimal: if the argument begins with 0x the proceeding characters will be interpreted
6500- will be interpreted as hex (base 16) for any numeric fields
6501- for float fields, hexadecimal input results in a precision
6502- limit (in converting input past the decimal point) of 10^-15</ p >
6503- < p > Character Constant: if the argument begins with a single quote character, the first byte
6504- of the next character will be interpreted as an 8-bit unsigned integer. If there are
6505- additional bytes, they will throw an error (unless the environment variable POSIXLY_CORRECT
6506- is set)</ p >
6507- < p > WRITTEN BY :
6508- Nathan E. Ross, et al. for the uutils project</ p >
6509- < p > MORE INFO :
6510- https://github.com/uutils/coreutils</ p >
6511- < p > COPYRIGHT :
6512- Copyright 2015 uutils project.
6513- Licensed under the MIT License, please see LICENSE file for details</ p >
65146349< h2 id ="examples-62 "> < a class ="header " href ="#examples-62 "> Examples</ a > </ h2 >
65156350< p > Print a text message:</ p >
65166351< pre > < code class ="language-shell "> printf "{{%s\n}}" "{{Hello world}}"
@@ -9985,11 +9820,11 @@ <h2 id="options-113"><a class="header" href="#options-113">Options</a></h2>
99859820</ dd >
99869821< dt > < code > --dereference-command-line-symlink-to-dir</ code > </ dt >
99879822< dd >
9988- < p > Do not dereference symlinks except when they link to directories and are given as command line arguments.</ p >
9823+ < p > Do not follow symlinks except when they link to directories and are given as command line arguments.</ p >
99899824</ dd >
99909825< dt > < code > --dereference-command-line</ code > , < code > -H</ code > </ dt >
99919826< dd >
9992- < p > Do not dereference symlinks except when given as command line arguments.</ p >
9827+ < p > Do not follow symlinks except when given as command line arguments.</ p >
99939828</ dd >
99949829< dt > < code > --no-group</ code > , < code > -G</ code > </ dt >
99959830< dd >
0 commit comments