.Dd Created:2025-10-03|Updated:2025-11-30|
.de ocsi
\\$*
,
..
.de oxr
.ocsi .Xr \\$*
..
.de oit
.It
\\$*
..
.de obdi
.Bl -dash -compact
.oit \\$*
..
.de obdl
.Bd -literal -compact
\\$*
..
.de onote
.Bl -hang -compact
.oit \\$*
.El
..
.de ocomm
.Bl -diag -compact
.oit \\$*
.El
..
.de opsy
.Pp
.Sy - \\$*
..
.de obc
.Bl -column \\$*
..
.de obc2
.obc opt desc
..
.de obc3
.obc option arguments description
..
.Dt OHAZOT.COM oh
.Os OpenBSD 7.7 linux|
.Nm ohazot
.Nd about ohazot.com
.Sh OHAZOT
.Bl -tag -compact
.It Sy contents
This site contains mainly documents about linux  (mostly Slackware), OpenBSD and terminal programs.
.It Sy setup
This site is running on openbsd using httpd.
The documents are written using mdoc using make to run mandoc.
.It Sy compatibility
This site can be accessed from a graphical browser or text browser.
.El
.Sh HOW TO
.Ss curl
.obc2
.It - The site can be accessed from curl to get the text version of the files using:
.D1 https://ohazot.com/:[es/][FILENAME][.oh]
.It - If no filename is given, a list of files is displayed.
.It - the extension is ommitted but the FILENAME.oh exists, it will be displayed.
.It - if es/ is added, it will search in Spanish.
.It - if the file exists only in English, it will show the English version.
.It - if accessed from a web browser it will convert to html.
.El
.Ss Download options
.obdi Use the
.In /downloads/latest.tar.gz
.oit Mirror the docs directories.
.Dl wget --mirror https://ohazot.com
.El
.Ss Local usage
.obdi command line:
.Dl man -M {PATH_TO_DOWNLOADS}/man -s oh {DOCUMENT}
.oit OpenBSD
.obdi add to /etc/man.conf : manpath [PATH_TO_DOWNLOADS]/man
.El
.oit Slackware
.obdi add export MANPATH=${MANPATH}:[PATH_TO_DOWNLOADS]/man
.El
.El
If added to man.conf or MANPATH, run
.Li man -s oh [DOCUMENT]
.Sh TODO
.opsy wip: 
translate to spanish.
.opsy next
.obdi improve makefile, add awk script for parsing.
.oit review old docs.
.El
.Ss docs
.Bl -column  ".Sy site " ".Sy roff_supported (oh) "
.It - review and standarize them.
.It - add category indexes.
.It - review docs and add # or $ accordingly to code lines, depending on whether the commands need root.
.El
.Ss manpages
review manpage site to use:
.Bl -column  ".Sy site " ".Sy roff_supported (oh) "
.It - Lk https://linux.die.net/ Linux Documentation die.net
was the original one, but requires JS, therefore is not compatible with text browsers. Discarded.
.It - Lk https://man.archlinux.org ArchLinux manpages
was the next option but the manpage for
.Xr lgogdownloader oh
cannot be found.
.It - Lk https://www.mankier.com ManKier
works on text browsers and has the manpage for lgogdownloader. Does not have netpbm manpage, only individual packages manpages.
.It - Lk https://manpages.org manpages.org
works on text browsers, has lgogdownloader and netpbm manpage. Search is off-putting.
.El
.Ss roff macros
decide whether to use macros on all documents or only mdoc and roff related documents for macro definitions reference.
.Bl -column  ".Sy site " ".Sy roff_supported (oh) "
.It - pros: simplifies writing the documents.
.It - cons: the documents are harder to read when using the file for mdoc reference.
.El
.Ss docs
Add the following docs: 
.oxr apropos 1
.Xr awk 1
(onetrueawk in Slackware)
,
.oxr grep 1
.oxr find 1
.ocsi regex
.oxr patterns 7
.ocsi fdm
.ocsi SQL
.ocsi SQLite3
.ocsi PostScript
.ocsi .Lk https://pikchr.org pikchr
.ocsi (La)TeX
.ocsi MySQL
.ocsi GLPI
.ocsi terminal games
.ocsi edbrowse
.ocsi surfraw
.ocsi dictd
.ocsi dwarf fortress
.oxr script 1
.ocsi thermal printer
.ocsi .Lk https://ratox.2f30.org ratox
.ocsi .Lk https://tox.chat tox chat
.oxr tmux 1
.ocsi forth
termux
.Ss protocols
Check if the following protocols can be added (and add the doc if implemented): 
.ocsi gopher
.oxr ftp 1
rss
\&.
.Sh NOTE
All docs have the links to their corresponding manpages for programs and other related links.
Check
.Lk https://man.openbsd.org/ OpenBSD manpages
and
.Lk https://man.archlinux.org/man ArchLinux manpages
according to your needs
or the documents for the required distribution.
More information can be found in:
.Xr links oh
\&.
.Sh SEE ALSO
.oxr history oh
.oxr openbsd oh
.oxr roff oh
.oxr make oh
.oxr mdoc oh
.oxr mandoc oh
.oxr httpd oh
.oxr ssl oh
.oxr linux oh
.oxr slackware oh
.oxr wget oh
.Xr privacy oh
.Sh AUTHORS
.An -nosplit
.Xr ohazot oh |
.Xr about oh |
.Lk https://ohazot.com ohazot.com
.Aq Mt admin@ohazot.com