emacs-devel
[Top][All Lists]
Advanced

[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)





reply via email to

[Prev in Thread] Current Thread [Next in Thread]