Format fixes and other updates in 2020/ferguson2
With this commit I should be able to return to the other entries though as Landon pointed out I might never finish this and this is a reason it might not have been as thorough as I could have been (another part is it's long). Nevertheless the formatting should now be okay along the lines of what was requested for all the winning entry markdown files.
This commit is contained in:
1 parent
86f0d5449e
commit
2ca6dc4021
6 files changed
+647
-562
No files matched your search
+24
-28
@@ -1,35 +1,36 @@
|
||||
.TH recode 1 "20 February 2023" "recode" "IOCCC 2020"
|
||||
.TH recode 1 "16 April 2023" "recode" "IOCCC 2020"
|
||||
.SH NAME
|
||||
recode \- A configuration tool for the IOCCC 2020 Enigma simulator w/various additional features for enhanced usage
|
||||
.SH SYNOPSIS
|
||||
\fBrecode [options]\fP
|
||||
\fBrecode\fP [\fB\-v\fP] [\fB\-r\fP] [\fB\-f\fI<input_file>\fP\fP] [\fB\-R\fI<string|file>\fP\fP] [\fB\-l\fI<output_file>\fP\fP]
|
||||
.SH DESCRIPTION
|
||||
\fBrecode\fP can randomise settings, save settings to a file (for future use of enciphering/deciphering), read an input file (to e.g. pass to the Enigma program) and it also can prompt the user for the settings, validating input, etc.
|
||||
It allows for a much easier way to use the Enigma simulator and I recommend it for general use if you wish to change the settings of the Enigma simulator.
|
||||
.SH OPTIONS
|
||||
.PP
|
||||
.TP
|
||||
\fB\-h\fP
|
||||
Show the options and exit.
|
||||
.PP
|
||||
.TQ
|
||||
\fB\-v\fP
|
||||
Display the selected settings in detail.
|
||||
.PP
|
||||
.TQ
|
||||
\fB\-r\fP
|
||||
Pseudo-randomly select the settings.
|
||||
.PP
|
||||
.TQ
|
||||
\fB\-f\<input file\>\fP
|
||||
Read input file as data file (e.g. to pipe to Enigma program).
|
||||
Notice that there is no space between the \fI\-f\fP and file name.
|
||||
.PP
|
||||
Notice that there is no space between the \fB\-f\fP and file name.
|
||||
.TQ
|
||||
\fB\-i\<input file\>\fP
|
||||
Alias for \fI\-f\fP option.
|
||||
.PP
|
||||
.TQ
|
||||
\fB\-R\<string|file\>\fP
|
||||
Parse settings string (or file with the same format). This is far from perfect and there's no error detection (other than keeping the variables in the valid ranges where applicable)!
|
||||
Notice that there is no space after the \fB\-R\fP.
|
||||
.PP
|
||||
.TQ
|
||||
\fB\-o\<output file\>\fP
|
||||
Save the settings (not the data read in) to the output file for reuse.
|
||||
Notice that there is no space between the \fB\-o\fP and file name.
|
||||
.PP
|
||||
.SH FILES
|
||||
\fIrecode.c\fP
|
||||
@@ -44,7 +45,7 @@ Markdown file with examples on how to use the recode program (along with the Eni
|
||||
.RS
|
||||
More information on the Enigma simulator IOCCC entry.
|
||||
.RE
|
||||
\fIchocolate\-cake.markdown\fP
|
||||
\fIchocolate\-cake.md\fP
|
||||
.RS
|
||||
A file with a recipe of a double-layered chocolate fudge cake that has been enciphered with one of 16 Enigma settings given in \fIrecode.md\fP which should give enough information on how to make use of the two programs in order to unlock this recipe (well worth it!).
|
||||
.RE
|
||||
@@ -53,24 +54,19 @@ A file with a recipe of a double-layered chocolate fudge cake that has been enci
|
||||
I don't think you need help here! :)
|
||||
.RE
|
||||
.SH BUGS
|
||||
.RS
|
||||
\fB\-\fP The \fB\-R\fP option doesn't detect errors.
|
||||
.RE
|
||||
.RS
|
||||
\fB\-\fP Doesn't handle input from other programs very well (e.g. \fBecho ...|./recode\fP).
|
||||
.PP
|
||||
The \fB\-R\fP option doesn't detect errors.
|
||||
.PP
|
||||
Doesn't handle input from other programs very well (e.g. \fBecho ...|./recode\fP).
|
||||
Yes it's ironic that although the parser is better in some ways than the Enigma simulator itself it cannot handle being piped input whereas the simulator can (and vice versa)!
|
||||
.RE
|
||||
.RS
|
||||
\fB\-\fP It was written by a human being.
|
||||
.RE
|
||||
.RS
|
||||
\fB\-\fP The source code is ugly. This is only partly intentional.
|
||||
.RE
|
||||
.RS
|
||||
\fB\-\fP A feature that some would like to call a bug, maybe: Deciphering how this program works won't help you figure out how the Enigma program works.
|
||||
.RE
|
||||
.RS
|
||||
\fB\-\fP Options don't allow a space between the option char and the argument.
|
||||
.PP
|
||||
It was written by a human being.
|
||||
.PP
|
||||
The source code is ugly. This is only clearly intentional.
|
||||
.PP
|
||||
A feature that some would like to call a bug, maybe: deciphering how this program works won't help you figure out how the Enigma program works.
|
||||
.PP
|
||||
Options don't allow a space between the option char and the argument.
|
||||
This in turn means that for options expecting a file name shell expansion won't occur which means using e.g. ~ will not correctly translate in the file name.
|
||||
.RE
|
||||
.SH EXAMPLES
|
||||
|
||||
Reference in new issue
Block a user