Blame
|
1 | # Man Pages |
||||||
| 2 | ||||||||
| 3 | % HELLO(1) Version 1.0 | Frivolous "Hello World" Documentation |
|||||||
| 4 | ||||||||
| 5 | NAME |
|||||||
| 6 | ==== |
|||||||
| 7 | ||||||||
| 8 | **hello** — prints Hello, World! |
|||||||
| 9 | ||||||||
| 10 | SYNOPSIS |
|||||||
| 11 | ======== |
|||||||
| 12 | ||||||||
| 13 | | **hello** \[**-o**|**--out** _file_] \[_dedication_] |
|||||||
| 14 | | **hello** \[**-h**|**--help**|**-v**|**--version**] |
|||||||
| 15 | ||||||||
| 16 | DESCRIPTION |
|||||||
| 17 | =========== |
|||||||
| 18 | ||||||||
| 19 | Prints "Hello, _dedication_!" to the terminal. If no dedication is |
|||||||
| 20 | given, uses the default dedication. The default dedication is chosen by |
|||||||
| 21 | the following sequence: |
|||||||
| 22 | ||||||||
| 23 | 1. Using the environment variable *DEFAULT_HELLO_DEDICATION* |
|||||||
| 24 | 2. Using the per-user configuration file, *~/.hellorc* |
|||||||
| 25 | 3. Using the system-wide configuration file, */etc/hello.conf* |
|||||||
| 26 | 4. Finally, using "world". |
|||||||
| 27 | ||||||||
| 28 | Options |
|||||||
| 29 | ------- |
|||||||
| 30 | ||||||||
| 31 | -h, --help |
|||||||
| 32 | ||||||||
| 33 | : Prints brief usage information. |
|||||||
| 34 | ||||||||
| 35 | -o, --output |
|||||||
| 36 | ||||||||
| 37 | : Outputs the greeting to the given filename. |
|||||||
| 38 | ||||||||
| 39 | The file must be an **open(2)**able and **write(2)**able file. |
|||||||
| 40 | ||||||||
| 41 | -v, --version |
|||||||
| 42 | ||||||||
| 43 | : Prints the current version number. |
|||||||
| 44 | ||||||||
| 45 | FILES |
|||||||
| 46 | ===== |
|||||||
| 47 | ||||||||
| 48 | *~/.hellorc* |
|||||||
| 49 | ||||||||
| 50 | : Per-user default dedication file. |
|||||||
| 51 | ||||||||
| 52 | */etc/hello.conf* |
|||||||
| 53 | ||||||||
| 54 | : Global default dedication file. |
|||||||
| 55 | ||||||||
| 56 | ENVIRONMENT |
|||||||
| 57 | =========== |
|||||||
| 58 | ||||||||
| 59 | **DEFAULT_HELLO_DEDICATION** |
|||||||
| 60 | ||||||||
| 61 | : The default dedication if none is given. Has the highest precedence |
|||||||
| 62 | if a dedication is not supplied on the command line. |
|||||||
| 63 | ||||||||
| 64 | BUGS |
|||||||
| 65 | ==== |
|||||||
| 66 | ||||||||
| 67 | See GitHub Issues: <https://github.com/[owner]/[repo]/issues> |
|||||||
| 68 | ||||||||
| 69 | ### AUTHOR |
|||||||
| 70 | *** |
|||||||
| 71 | ||||||||
| 72 | Bob Green <bob@chippers.org.uk> |
|||||||
| 73 | ||||||||
| 74 | SEE ALSO |
|||||||
| 75 | ======== |
|||||||
| 76 | ||||||||
| 77 | **hi(1)**, **hello(3)**, **hello.conf(5)** |
|||||||