I've found that the text version of FAQ has some format problems,
and then found that it was already reported one-and-half year ago:
> 2021/01/30 4:35, Bart Schaefer <schaefer@xxxxxxxxxxxxxxxx> wrote:
>
> However, when I do "cd Etc; make FAQ" on Ubuntu 20.04.1 LTS, I get
> some strange formatting.
(snip)
> That is, most paragraphs get a hanging left indent (outdent?),
It seems yodl removes any indent of the 1st line of a paragraph in
text mode by default (a paragraph is started by a blank line).
But at line 152 of the FAQ:
(As a method of reading the following in Emacs, you can type \M-2
\C-x $ to make all the indented text vanish, ...
I have _NO_ experience with emacs, but I guess the lack of indent
would break this feature?
With some trial and error, I found the indent can be preserved by the
following patch.
But with this patch two or more consecutive blank lines in FAQ.yo
are copied to the text output as is. I guess the symbol XXparagraph
contains all the preceding blank lines. Using ifnewparagraph() didn't
work. So I removed many blank lines. These trivial changes are only
included in the attached file.
diff --git a/Etc/FAQ.yo b/Etc/FAQ.yo
index 8a6895454..ebe86c202 100644
--- a/Etc/FAQ.yo
+++ b/Etc/FAQ.yo
@@ -57,6 +57,11 @@ def(emdash)(0)(\
whentxt(--))\
SUBST(_LPAR_)(CHAR(40))\
SUBST(_RPAR_)(CHAR(41))
+COMMENT(-- preserve the indent of the 1st line of paragraph --)\
+IFDEF(txt)(\
+ DEFINESYMBOL(XXparagraph)()\
+ PUSHMACRO(PARAGRAPH)(0)(SYMBOLVALUE(XXparagraph))\
+)()
myreport(Z-Shell Frequently-Asked Questions)(Peter Stephenson)(2010/02/15)
COMMENT(-- the following are for Usenet and must appear first)\
description(\
Attachment:
FAQ-indent.patch
Description: Binary data