New man page in roff

This commit is contained in:
llathasa-veleth 2021-08-27 21:32:02 +03:00
parent 49d9cb0523
commit 9b93c4d759
3 changed files with 110 additions and 117 deletions

110
uwufetch.1 Normal file
View file

@ -0,0 +1,110 @@
.\" A little documentation for future use
.\" This a comment
.\" TH request sets the title of the man page and the section (between 1 and 8)
.\" SH is a primary section heading
.\" TP sets up an indented paragraph with label
.\" B makes text appear in bold face
.\" I makes text appear in italic face
.\" inline versions would look like \fBthis\fR and \fIthis\fR
.\" EX and EE surrounds example section with text as is, with no empty lines in between the actual lines
.TH uwufetch 1 "27 August 2021" "1.4" "A meme system info tool for Linux"
.SH DESCRIPTION
UwUfetch is a program inspired by neofetch and ufetch, that takes system information and prints it in terminal in an UwU way, with either UwU ascii or image logo.
.SH SYNOPSYS
\fBuwufetch\fR [\fIOPTIONS\fR] [\fIARGUMENTS\fR]
.SH OPTIONS
.TP
.B -a --ascii
prints the logo as ascii text (default)
.TP
.B -c --config
you can change config path
.TP
.B -d --distro
you can choose the logo to print by the distro name
.TP
.B -h --help
prints a help page
.TP
.B -i --image
prints image instead of ascii logo uses a custom image if one is provided
.TP
.B -l --list
prints a list of all supported distributions
.SH CONFIGURATION
The config file is located in $HOME/.config/uwufetch/config (you need to create it), but you can change the path by using the \fB--config\fR option.
.TP
.SH EXAMPLE
.EX
distro=arch
image="~/Pictures/picture.png"
ascii=false
user=true
os=true
host=true
kernel=true
cpu=true
gpu=false
ram=true
resolution=true
shell=true
pkgs=true
uptime=true
colors=true
.EE
.SH SUPPORTED DISTRIBUTIONS
Distribution name -d \fBoption\fR
.TP
.SH FULLY SUPPORTED
.EX
Nyalpine \fBalpine\fR
Nyarch Linuwu \fBarch\fR
Nyartix Linuwu \fBartix\fR
Debinyan \fBdebian\fR
Fedowa \fBfedora\fR
GentOwO \fBgentoo\fR
GnUwU gUwUix \fBguix\fR
Miwint \fBlinuxmint\fR
Myanjawo \fBmanjaro\fR
Myanjawo AWM \fBmanjaro-arm\fR
OwOpenSUSE \fBopensuse-leap\fR
Pop OwOs \fBpop\fR
RaspNyan \fBraspbian\fR
UwUntu \fBubuntu\fR
OwOid \fBvoid\fR
Nyandroid \fBandroid\fR
Unknown (tux logo) \fBunknown\fR
.EE
.TP
.SH IMAGE OR ASCII ONLY
.EX
endeavOwO \fBendeavour\fR
KDE NeOwOn \fBneon\fR
nixOwOs \fBnixos\fR
Swackwawe \fBslackware\fR
sOwOlus \fBsolus\fR
FweeBSD \fBfreebsd\fR
OwOpenBSD \fBopenbsd\fR
macOwOS \fBmacos\fR
WinyandOwOws \fBwindows\fR
.EE
.SH EXAMPLES
.EX
uwufetch -d arch # uses ascii Arch logo
uwufetch --custom some_image.png # prints custom image (no full path is needed)
uwufetch -i -d artix # uses Artix image logo (which is also uwu)
.EE
.SH DEPENDENCIES
.TP 8
.B lshw
better gpu info
.TP
.B viu
print images instead of ascii logo
.TP
.B kitty
better image viewing
.P
All of these dependencies are optional. There are no required dependencies.
.SH LICENSE AND COPYRIGHT
uwufetch is provided under the GPL3 license, for copyright info read https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md.

Binary file not shown.

View file

@ -1,117 +0,0 @@
% UWUFETCH(1) uwufetch 1.4
% TheDarkBug
% April 2021
<!---
I am using markdown instead of troff because i don't know how to use it, and the same could be for some people.
I also don't know if this is a good practice, but it works, so I am keeping it.
To "compile" this file you need pandoc (https://pandoc.org).
--->
# NAME
uwufetch - A meme system info tool for Linux, based on nyan/uwu trend on r/linuxmasterrace.
# SYNOPSIS
**uwufetch** [*OPTIONS*] [*ARGUMENTS*]
# OPTIONS
-a --ascii\
prints the logo as ascii text (default)
-c --config\
you can change config path
-d --distro\
you can choose the logo to print by the distro name
-h --help\
prints a help page
-i --image\
prints image instead of ascii logo\
uses a custom image if one is provided
-l --list\
prints a list of all supported distributions
# CONFIG FILE
The config file is located in $HOME/.config/uwufetch/config (you need to create it), but you can change the path by using the `--config` option.
## EXAMPLE:
distro=arch\
image="~/Pictures/picture.png"\
ascii=false\
user=true\
os=true\
host=true\
kernel=true\
cpu=true\
gpu=false\
ram=true\
resolution=true\
shell=true\
pkgs=true\
uptime=true\
colors=true
# SUPPORTED DISTRIBUTIONS
Distribution name\ \ \ \ \ -d option
Nyalpine\ \ \ \ \ \ \ \ \ alpine\
Nyarch Linuwu\ \ \ \ \ \ \ arch\
Nyartix Linuwu\ \ \ \ \ \ \ artix\
Debinyan\ \ \ \ \ \ \ \ \ debian\
Fedowa\ \ \ \ \ \ \ \ \ \ \ fedora\
GentOwO\ \ \ \ \ \ \ \ \ \ gentoo\
GnUwU gUwUix\ \ \ \ \ \ \ guix\
Miwint\ \ \ \ \ \ \ \ \ \ \ linuxmint\
Myanjawo\ \ \ \ \ \ \ \ \ manjaro\
Myanjawo AWM\ \ \ \ \ \ \ \\"manjaro-arm\\"\
OwOpenSUSE\ \ \ \ \ \ \ \ \ \\"opensuse-leap\\"\
Pop OwOs\ \ \ \ \ \ \ \ \ pop\
RaspNyan\ \ \ \ \ \ \ \ \ raspbian\
UwUntu\ \ \ \ \ \ \ \ \ \ \ ubuntu\
OwOid\ \ \ \ \ \ \ \ \ \ \ \\"void\\"\
Nyandroid\ \ \ \ \ \ \ \ \ android\
Unknown (tux logo)\ \ \ \ \ unknown
--image/ascii only distributions--\
endeavOwO\ \ \ \ \ \ \ \ \ endeavour\
KDE NeOwOn\ \ \ \ \ \ \ \ \ neon\
nixOwOs\ \ \ \ \ \ \ \ \ \ nixos\
Swackwawe\ \ \ \ \ \ \ \ \ slackware\
sOwOlus\ \ \ \ \ \ \ \ \ \ solus\
FweeBSD\ \ \ \ \ \ \ \ \ \ freebsd\
OwOpenBSD\ \ \ \ \ \ \ \ \ openbsd\
macOwOS\ \ \ \ \ \ \ \ \ \ macos\
WinyandOwOws\ \ \ \ \ \ \ windows
# DESCRIPTION
UwUfetch is a program inspired by neofetch and ufetch, that takes system informations\
and prints them in the terminal in an UwU way, with and UwU ascii logo or image.
# EXAMPLES
uwufetch -d arch\ \ \ \ \ \ \ \ \ \ # prints arch logo\
uwufetch -\-custom some_image.png\ \ # prints custom image (does not need full path)\
ueufetch -i -d artix\ \ \ \ \ \ \ \ # prints artix image
# DEPENDENCIES
lshw\ \ \ better gpu info\
viu\ \ \ \ print images instead of ascii logo\
kitty\ \ \ better image viewing
All of these dependencies are optional. There are no required dependencies.
# LICENSE AND COPYRIGHT
uwufetch is provided under the GPL3 license, for copyright info read\
https://github.com/TheDarkBug/uwufetch/tree/main/res/COPYRIGHT.md.