[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Indentation conventions for Info manuals; recognizing code
From: |
Richard Stallman |
Subject: |
Re: Indentation conventions for Info manuals; recognizing code |
Date: |
Mon, 08 Mar 2021 00:37:21 -0500 |
[[[ To any NSA and FBI agents reading my email: please consider ]]]
[[[ whether defending the US Constitution against all enemies, ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]
The structure of an Info file is documented somewhere, but style
conventions are not. The style conventions for Info files are defined
by what properly written Texinfo source converts into.
I did not write separate documentation for Info format because (1) it
would be more or less duplicative and (2) Info files are normally
generated from Texinfo files.
> But other manuals don't seem to use the same indentation. Several
> (org, eintr, ccmode, efaq(-w32),...) indent code (including Elisp)
> 5 spaces - which is the same amount that other, non-code text is
> indented.
Aside from eintr, I don't know anything specific about those manuals.
The eintr manual was written by Bob Chassell; I presume it is still
generated from Texinfo, right? So I find it puzzling that it produces
a different format in the Info file.
Why does it do that? Is the source formatted in an unusual way? Does
it somehow specify different parameters for generating the Info file?
--
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)