From 3f04afcd043c18e92de744e1100f671e500e6e9c Mon Sep 17 00:00:00 2001 From: Kevin Day Date: Sat, 7 Jan 2023 19:27:02 -0600 Subject: [PATCH] Update: Add man page documentation for fss_status_code. --- level_3/fss_status_code/data/build/settings | 2 + .../data/documentation/man/man1/fss_status_code.1 | 73 ++++++++++++++++++++++ 2 files changed, 75 insertions(+) create mode 100644 level_3/fss_status_code/data/documentation/man/man1/fss_status_code.1 diff --git a/level_3/fss_status_code/data/build/settings b/level_3/fss_status_code/data/build/settings index 51e5b37..fa38af6 100644 --- a/level_3/fss_status_code/data/build/settings +++ b/level_3/fss_status_code/data/build/settings @@ -28,6 +28,8 @@ build_sources_program main.c build_sources_headers fss_status_code.h common.h +build_sources_documentation man + build_script yes build_shared yes build_static no diff --git a/level_3/fss_status_code/data/documentation/man/man1/fss_status_code.1 b/level_3/fss_status_code/data/documentation/man/man1/fss_status_code.1 new file mode 100644 index 0000000..27abf27 --- /dev/null +++ b/level_3/fss_status_code/data/documentation/man/man1/fss_status_code.1 @@ -0,0 +1,73 @@ +.TH FSS_STATUS_CODE "1" "January 2023" "FLL - FSS Status Code 0.6.3" "User Commands" +.SH NAME +fss_status_code \- Convert to or from status codes returned by FLL programs with FSS codes. +.SH SYNOPSIS +.B fss_status_code +[\fI\,OPTIONS\/\fR] [\fI\,STATUS CODES\/\fR] +.SH DESCRIPTION +.PP +The FLL programs use a \fB16-bit unsigned integer\fR to represent the return status of programs and functions. +Programs may print a generic error with one of these codes. +This is a tool for converting to or converting from these codes. + +The \fB16-bit unsigned integer\fR also has the first two high-order bits used to represent flags. +These flags are the \fBerror\fR bit and the \fBwarning\fR bit. +When neither of these flags are set, then the status is considered \fBfine\f. + +This operates identical to the \fBstatus_codes\fR program except that this program handles additional codes regarding FSS. +These special codes numericaly appear after the \fBF_status_code_last\fR code. +These codes stop at the \fBF_fss_status_code_last\fR code. + +Each code will be printed on its own line. +Errors regarding each code may be printed on its own line. +.SH OPTIONS +.TP +\fB\{+h, ++help\fR +Print the help message. +.TP +\fB+d, ++dark\fR +Output using colors that show up better on dark backgrounds +.TP +\fB+l, ++light\fR +Output using colors that show up better on light backgrounds. +.TP +\fB+n, ++no_color\fR +Do not print using color. +.TP +\fB+Q, ++quiet\fR +Decrease verbosity, silencing most output. +.TP +\fB+E, ++error\fR +Decrease verbosity, using only error output. +.TP +\fB+N, ++normal\fR +Set verbosity to normal. +.TP +\fB+V, ++verbose\fR +Increase verbosity beyond normal output. +.TP +\fB+D, ++debug\fR +Enable debugging, significantly increasing verbosity beyond normal output. +.TP +\fB+v, ++version\fR +Print only the version number. +.TP +\fB\-f, \-\-fine\fR +Print F_true or F_false if status code is neither an error nor a warning or print number with neither the error code nor the warning code bits set. +.TP +\fB\-w, \-\-warning\fR +Print F_true or F_false if status code is a warning or print number with warning code bit set. +.TP +\fB\-e, \-\-error\fR +Print F_true or F_false if status code is an error or print number with error code bit set. +.TP +\fB\-n, \-\-number\fR +Convert status code name to number. +.SH STATUS CODES +.TP +Either code strings, such as \fBF_none\fR, or digits, such as \fB197\fR. +.SH AUTHOR +Written by Kevin Day. +.SH STATUS CODES +.PP +Copyright \(co 2023 Kevin Day, GNU LGPL Version 2.1 or later. -- 1.8.3.1