Generate man page from --help and --version

This commit is contained in:
Dylan Araps 2016-12-14 12:42:58 +11:00
parent f3bfd5a9f5
commit 2dfa044d4c
1 changed files with 81 additions and 25 deletions

106
neofetch
View File

@ -3022,38 +3022,51 @@ cache_uname() {
# FINISH UP # FINISH UP
usage() { printf "%s" " usage() { printf "%s" "\
NEOFETCH Usage: neofetch --option \"value\" --option \"value\"
USAGE: neofetch --option \"value\" --option \"value\" Neofetch is a CLI system information tool written in BASH.
NOTE: There's also a config option for each flag below. NOTE: Every launch flag has a config option.
Options:
INFO
Info:
--disable infoname Allows you to disable an info line from appearing --disable infoname Allows you to disable an info line from appearing
in the output. in the output.
NOTE: You can supply multiple args. eg.
'neofetch --disable cpu gpu disk shell' NOTE: You can supply multiple args. eg. 'neofetch --disable cpu gpu disk shell'
NOTE: The arguments must all be lowercase.
--os_arch on/off Hide/Show OS architecture. --os_arch on/off Hide/Show OS architecture.
--speed_type type Change the type of cpu speed to display. --speed_type type Change the type of cpu speed to display.
Possible values: current, min, max, bios, Possible values: current, min, max, bios,
scaling_current, scaling_min, scaling_max scaling_current, scaling_min, scaling_max
NOTE: This only support Linux with cpufreq. NOTE: This only support Linux with cpufreq.
--cpu_shorthand type Shorten the output of CPU --cpu_shorthand type Shorten the output of CPU
Possible values: name, speed, tiny, on, off Possible values: name, speed, tiny, on, off
--cpu_cores type Whether or not to display the number of CPU cores --cpu_cores type Whether or not to display the number of CPU cores
Takes: logical, physical, off Takes: logical, physical, off
NOTE: 'physical' doesn't work on BSD. NOTE: 'physical' doesn't work on BSD.
--cpu_speed on/off Hide/Show cpu speed. --cpu_speed on/off Hide/Show cpu speed.
--cpu_temp on/off Hide/Show cpu temperature. --cpu_temp on/off Hide/Show cpu temperature.
NOTE: This only works on Linux and BSD. NOTE: This only works on Linux and BSD.
NOTE: For FreeBSD-based systems, you need to enable coretemp
kernel module. NOTE: For FreeBSD-based systems, you need to enable coretemp kernel module.
--distro_shorthand on/off Shorten the output of distro (tiny, on, off) --distro_shorthand on/off Shorten the output of distro (tiny, on, off)
NOTE: This option won't work in Windows (Cygwin) NOTE: This option won't work in Windows (Cygwin)
--kernel_shorthand on/off Shorten the output of kernel --kernel_shorthand on/off Shorten the output of kernel
NOTE: This option won't work in BSDs (except PacBSD and PC-BSD) NOTE: This option won't work in BSDs (except PacBSD and PC-BSD)
--uptime_shorthand on/off Shorten the output of uptime (tiny, on, off) --uptime_shorthand on/off Shorten the output of uptime (tiny, on, off)
--refresh_rate on/off Whether to display the refresh rate of each monitor --refresh_rate on/off Whether to display the refresh rate of each monitor
Unsupported on Windows Unsupported on Windows
@ -3069,20 +3082,23 @@ usage() { printf "%s" "
--birthday_time on/off Enable/Disable showing the time in birthday output --birthday_time on/off Enable/Disable showing the time in birthday output
--birthday_format format Format the birthday output. (Uses 'date' cmd format) --birthday_format format Format the birthday output. (Uses 'date' cmd format)
Text Formatting: TEXT FORMATTING
--colors x x x x x x Changes the text colors in this order: --colors x x x x x x Changes the text colors in this order:
title, @, underline, subtitle, colon, info title, @, underline, subtitle, colon, info
--underline on/off Enable/Disable the underline. --underline on/off Enable/Disable the underline.
--underline_char char Character to use when underlining title --underline_char char Character to use when underlining title
--bold on/off Enable/Disable bold text --bold on/off Enable/Disable bold text
Color Blocks: COLOR BLOCKS
--color_blocks on/off Enable/Disable the color blocks --color_blocks on/off Enable/Disable the color blocks
--block_width num Width of color blocks in spaces --block_width num Width of color blocks in spaces
--block_height num Height of color blocks in lines --block_height num Height of color blocks in lines
--block_range start end Range of colors to print as blocks --block_range start end Range of colors to print as blocks
Bars: BARS
--bar_char 'elapsed char' 'total char' --bar_char 'elapsed char' 'total char'
Characters to use when drawing bars. Characters to use when drawing bars.
--bar_border on/off Whether or not to surround the bar with '[]' --bar_border on/off Whether or not to surround the bar with '[]'
@ -3097,8 +3113,8 @@ usage() { printf "%s" "
Takes: bar, infobar, barinfo, off Takes: bar, infobar, barinfo, off
--disk_display mode Bar mode. --disk_display mode Bar mode.
Takes: bar, infobar, barinfo, off Takes: bar, infobar, barinfo, off
IMAGE
Image:
--image type Image source. Where and what image we display. --image type Image source. Where and what image we display.
Possible values: wall, ascii, Possible values: wall, ascii,
/path/to/img, /path/to/dir/, off /path/to/img, /path/to/dir/, off
@ -3117,39 +3133,79 @@ usage() { printf "%s" "
--bg_color color Background color to display behind transparent image. --bg_color color Background color to display behind transparent image.
This only works with w3m. This only works with w3m.
--gap num Gap between image and text. --gap num Gap between image and text.
NOTE: --gap can take a negative value which will
move the text closer to the left side. NOTE: --gap can take a negative value which will move the text closer to the left side.
--clean Delete cached files and thumbnails. --clean Delete cached files and thumbnails.
Ascii: ASCII
--ascii value Where to get the ascii from, Possible values: --ascii value Where to get the ascii from, Possible values:
distro, /path/to/ascii distro, /path/to/ascii
--ascii_colors x x x x x x Colors to print the ascii art --ascii_colors x x x x x x Colors to print the ascii art
--ascii_distro distro Which Distro's ascii art to print --ascii_distro distro Which Distro's ascii art to print
NOTE: Arch and Ubuntu have 'old' logo varients. NOTE: Arch and Ubuntu have 'old' logo varients.
NOTE: Use 'arch_old' or 'ubuntu_old' to use the old logos. NOTE: Use 'arch_old' or 'ubuntu_old' to use the old logos.
NOTE: Ubuntu has flavor varients. NOTE: Ubuntu has flavor varients.
NOTE: Change this to 'Lubuntu', 'Xubuntu', 'Ubuntu-GNOME'
or 'Ubuntu-Budgie' to use the flavors. NOTE: Change this to 'Lubuntu', 'Xubuntu', 'Ubuntu-GNOME' or 'Ubuntu-Budgie' to use the flavors.
--ascii_logo_size Size of ascii logo. --ascii_logo_size Size of ascii logo.
Supported distros: Arch, Gentoo, Crux, OpenBSD. Supported distros: Arch, Gentoo, Crux, OpenBSD.
--ascii_bold on/off Whether or not to bold the ascii logo. --ascii_bold on/off Whether or not to bold the ascii logo.
--logo | -L Hide the info text and only show the ascii logo. -L, --logo Hide the info text and only show the ascii logo.
Screenshot: SCREENSHOT
--scrot | -s /path/to/img Take a screenshot, if path is left empty the screen-
-s, --scrot /path/to/img Take a screenshot, if path is left empty the screen-
shot function will use \$scrot_dir and \$scrot_name. shot function will use \$scrot_dir and \$scrot_name.
--upload | -su /pth/t/img Same as --scrot but uploads the scrot to a website. -su, --upload /path/to/img Same as --scrot but uploads the scrot to a website.
--image_host Website to upload scrots to. Takes: imgur, teknik --image_host Website to upload scrots to. Takes: imgur, teknik
--scrot_cmd cmd Screenshot program to launch --scrot_cmd cmd Screenshot program to launch
Other: OTHER
--config /path/to/config Specify a path to a custom config file --config /path/to/config Specify a path to a custom config file
--config none Launch the script without a config file --config none Launch the script without a config file
--help Print this text and exit --help Print this text and exit
--version Show neofetch version --version Show neofetch version
-v Display error messages. -v Display error messages.
-vv Display a verbose log for error reporting. -vv Display a verbose log for error reporting.
Report bugs to https://github.com/dylanaraps/neofetch/issues
"
exit 1
}
version() { printf "%s" "\
Neofetch 2.1.0
Copyright (c) 2016 Dylan Araps
License MIT: Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Written by Dylan Araps with help from the following people:
https://github.com/dylanaraps/neofetch/contributors
" "
exit 1 exit 1
} }
@ -3320,7 +3376,7 @@ get_args() {
"-v") verbose="on" ;; "-v") verbose="on" ;;
"-vv") set -x; verbose="on" ;; "-vv") set -x; verbose="on" ;;
"--help") usage ;; "--help") usage ;;
"--version") printf "%s\n" "Neofetch 2.1.0"; exit ;; "--version") version ;;
esac esac
shift shift