• :r !makeinfo --help

    From Maurice Kinal@2:280/464.113 to Grant Weasner on Sat May 24 06:55:54 2025
    Hej Grant!

    Usage: makeinfo [OPTION]... TEXINFO-FILE...

    Translate Texinfo source documentation to various other formats, by default Info files suitable for reading online with Emacs or standalone GNU Info.

    This program is commonly installed as both `makeinfo' and `texi2any';
    the behavior is identical, and does not depend on the installed name.

    General options:
    --document-language=STR locale to use in translating Texinfo keywords
    for the output document (default C).
    --error-limit=NUM quit after NUM errors (default 100).
    --force preserve output even if errors.
    --help display this help and exit.
    --no-validate suppress node cross-reference validation.
    --no-warn suppress warnings (but not errors).
    --conf-dir=DIR search also for initialization files in DIR.
    --init-file=FILE load FILE to modify the default behavior.
    -c, --set-customization-variable VAR=VAL set customization variable VAR
    to value VAL.
    --trace-includes print names of included files.
    -v, --verbose explain what is being done.
    --version display version information and exit.

    Output format selection (default is to produce Info):
    --docbook output Docbook XML.
    --html output HTML.
    --epub3 output EPUB 3.
    --latex output LaTeX.
    --plaintext output plain text rather than Info.
    --xml output Texinfo XML.
    --dvi, --dvipdf, --ps, --pdf call texi2dvi to generate given output,
    after checking validity of TEXINFO-FILE.

    General output options:
    -E, --macro-expand=FILE output macro-expanded source to FILE,
    ignoring any @setfilename.
    --no-headers suppress node separators, Node: lines, and menus
    from Info output (thus producing plain text)
    or from HTML (thus producing shorter output).
    Also, if producing Info, write to
    standard output by default.
    --no-split suppress any splitting of the output;
    generate only one output file.
    --[no-]number-sections output chapter and sectioning numbers;
    default is on.
    -o, --output=DEST output to DEST.
    With split output, create DEST as a directory
    and put the output files there.
    With non-split output, if DEST is already
    a directory or ends with a /,
    put the output file there.
    Otherwise, DEST names the output file.
    --disable-encoding do not output accented and special characters
    in Info and plain text output based on document
    encoding.
    --enable-encoding override --disable-encoding (default).

    Options for Info and plain text:
    --fill-column=NUM break Info lines at NUM columns (default 72).
    --footnote-style=STYLE output footnotes in Info according to STYLE:
    `separate' to put them in their own node;
    `end' to put them at the end of the node, in
    which they are defined (this is the default).
    --paragraph-indent=VAL indent Info paragraphs by VAL spaces (default 3).
    If VAL is `none', do not indent; if VAL is
    `asis', preserve existing indentation.
    --split-size=NUM split Info files at size NUM (default 300000).


    Options for HTML:
    --css-include=FILE include FILE in HTML <style> output;
    read stdin if FILE is -.
    --css-ref=URL generate CSS reference to URL.
    --internal-links=FILE produce list of internal links in FILE.
    --split=SPLIT split at SPLIT, where SPLIT may be `chapter',
    `section' or `node'.
    --transliterate-file-names use file names in ASCII transliteration.
    --node-files produce redirection files for nodes and
    anchors; default is set only if split.

    Options for DVI/PS/PDF:
    --Xopt=OPT pass OPT to texi2dvi; can be repeated.

    Input file options:
    -D VAR define the variable VAR, as with @set.
    -D 'VAR VAL' define VAR to VAL (one shell argument).
    -I DIR append DIR to the @include search path.
    -P DIR prepend DIR to the @include search path.
    -U VAR undefine the variable VAR, as with @clear.

    Conditional processing in input:
    --ifdocbook process @ifdocbook and @docbook even if
    not generating Docbook.
    --ifhtml process @ifhtml and @html even if not generating HTML.
    --ifinfo process @ifinfo even if not generating Info.
    --iflatex process @iflatex and @latex.
    --ifplaintext process @ifplaintext even if not generating plain text.
    --iftex process @iftex and @tex.
    --ifxml process @ifxml and @xml.
    --no-ifdocbook do not process @ifdocbook and @docbook text.
    --no-ifhtml do not process @ifhtml and @html text.
    --no-ifinfo do not process @ifinfo text.
    --no-iflatex do not process @iflatex and @latex text.
    --no-ifplaintext do not process @ifplaintext text.
    --no-iftex do not process @iftex and @tex text.
    --no-ifxml do not process @ifxml and @xml text.

    Also, for the --no-ifFORMAT options, do process @ifnotFORMAT text.

    The defaults for the @if... conditionals depend on the output format:
    if generating Docbook, --ifdocbook is on and the others are off;
    if generating HTML, --ifhtml is on and the others are off;
    if generating Info, --ifinfo is on and the others are off;
    if generating plain text, --ifplaintext is on and the others are off;
    if generating LaTeX, --iflatex is on and the others are off;
    if generating XML, --ifxml is on and the others are off.

    Examples:
    makeinfo foo.texi write Info to foo's @setfilename
    makeinfo --html foo.texi write HTML to @setfilename
    makeinfo --xml foo.texi write Texinfo XML to @setfilename
    makeinfo --docbook foo.texi write Docbook XML to @setfilename
    makeinfo --plaintext foo.texi write plain text to standard output
    makeinfo --pdf foo.texi write PDF using texi2dvi

    makeinfo --html --no-headers foo.texi write html without node lines, menus
    makeinfo --number-sections foo.texi write Info with numbered sections
    makeinfo --no-split foo.texi write one Info file however big

    Email bug reports to bug-texinfo@gnu.org,
    general questions and discussion to help-texinfo@gnu.org.
    Texinfo home page: https://www.gnu.org/software/texinfo/

    Het leven is goed,
    Maurice

    o- -o o- -o
    /) (\ /) (\
    ^^ ^^ ^^ ^^
    ... Sibb æfre ne mæg wiht onwendan, þam ðe wel þenceð.
    Kinship can never in any way be set aside, for one who thinks rightly.
    --- GNU bash, version 5.2.37(1)-release (x86_64-pc-linux-gnu)
    * Origin: Little Mikey's EuroPoint @ (2:280/464.113)
  • From Maurice Kinal@2:280/464.113 to Grant Weasner on Sun May 25 06:31:57 2025
    Hej Grant!

    Unfortunatly when I said info file, the files I'm working with aren't
    truley textinfo files.

    Ah! I get it now. I've been doing things like that for decades now, such as converting purely text messages to fidonet MSGs, this message being a prime example of that.

    I respect your tenacity, especially these days given the lack of cooperation and compatibilty. A well formatted text file is worth 100s of overbloated documents that have nothing of importance to say, nevermind teach.

    Het leven is goed,
    Maurice

    -o o- o- o-
    (\ /) /) /)
    ^^ ^^ ^^ ^^
    ... Swa fulre fæt, swa hit mann sceal fægror beran.
    The fuller the cup, the more carefully it must be carried.
    --- GNU bash, version 5.2.37(1)-release (x86_64-pc-linux-gnu)
    * Origin: Little Mikey's EuroPoint @ (2:280/464.113)