Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: [PATCH] FAQ update for aliasing



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



Messages sorted by: Reverse Date, Date, Thread, Author