FAQ and yodl

FAQ and yodl

[Clint Adams]

tanaka19991027/Etc% make
cd . && yodl2txt FAQ.yo && mv -f FAQ.txt FAQ
Yodl2txt 1.31.16
Yodl is processing a(n) report
FAQ.yo: 522: USECOUNTER
FAQ.yo: 522: no counter XXenumcounter defined
FAQ.yo: 522: last parsed symbol: `CHAR'
yodl indicates failure!
make: *** [FAQ] Error 1

If I put SETCOUNTER(XXenumcounter)(0) on line 503 above
enumerate():

tanaka19991027/Etc% make
cd . && yodl2txt FAQ.yo && mv -f FAQ.txt FAQ
Yodl2txt 1.31.16
Yodl is processing a(n) report
FAQ.yo: 502: SETCOUNTER
FAQ.yo: 502: no counter XXenumcounter defined
FAQ.yo: 502: last parsed symbol: `('
yodl indicates failure!
make: *** [FAQ] Error 1


Obviously I don't know what I'm doing, but what's wrong here?

Re: FAQ and yodl

[Bart Schaefer]

On Oct 27,  2:40pm, Clint Adams wrote:
} Subject: FAQ and yodl
}
} tanaka19991027/Etc% make
} cd . && yodl2txt FAQ.yo && mv -f FAQ.txt FAQ
} Yodl2txt 1.31.16

I've got version 1.22, and it seems to work OK.


-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com

PATCH: FAQ acceptable to yodl 1.31

[Clint Adams]

> I've got version 1.22, and it seems to work OK.

Hmm..

Does it choke on this?

*** Etc/FAQ.yo.old      Wed Oct 27 15:29:53 1999
--- Etc/FAQ.yo  Wed Oct 27 15:28:46 1999
***************
*** 500,505 ****
--- 500,506 ----
    substantial.
  
    As a summary of the status:
+   NEWCOUNTER(XXenumcounter)
    enumerate(
    myeit() because of all the options it is not safe to assume a general
       zsh run by a user will behave as if sh or ksh compatible;

Re: PATCH: FAQ acceptable to yodl 1.31

[Bart Schaefer]

On Oct 27,  3:33pm, Clint Adams wrote:
} Subject: PATCH: FAQ acceptable to yodl 1.31
}
} > I've got version 1.22, and it seems to work OK.
} 
} Hmm..
} 
} Does it choke on this?

YODL to plain ASCII Converter V1.22 (1996-1997)

Yodl is processing a(n) report
yodl: FAQ.yo [near 503],
during NEWCOUNTER:
counter XXenumcounter already exists
(last parsed symbol: `<newline>')
yodl indicates failure!
make: *** [FAQ] Error 1


-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com

Re: PATCH: FAQ acceptable to yodl 1.31

[Clint Adams]

> (last parsed symbol: `<newline>')
> yodl indicates failure!
> make: *** [FAQ] Error 1

Damn.  Configure-time check of yodl version and then
run sed on FAQ.yo?  Seems silly.

Re: PATCH: FAQ acceptable to yodl 1.31

[Bart Schaefer]

On Oct 27,  3:53pm, Clint Adams wrote:
} Subject: Re: PATCH: FAQ acceptable to yodl 1.31
}
} > (last parsed symbol: `<newline>')
} > yodl indicates failure!
} > make: *** [FAQ] Error 1
} 
} Damn.  Configure-time check of yodl version and then
} run sed on FAQ.yo?  Seems silly.

Well, that's why there's the zsh*-doc.tar.gz file ...

-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com

Re: PATCH: FAQ acceptable to yodl 1.31

[Tanaka Akira]

In article <19991027155353.A2441@dman.com>,
  Clint Adams <schizo@debian.org> writes:

> Damn.  Configure-time check of yodl version and then
> run sed on FAQ.yo?  Seems silly.

I removed XXenumcounter from FAQ.yo.
This seems to work with Yodl 1.22 and 1.31.16.

Index: Etc/FAQ.yo
===================================================================
RCS file: /projects/zsh/zsh/Etc/FAQ.yo,v
retrieving revision 1.1.1.12
diff -u -F^( -r1.1.1.12 FAQ.yo
--- Etc/FAQ.yo	1999/10/27 19:36:49	1.1.1.12
+++ Etc/FAQ.yo	1999/10/27 20:56:58
@@ -31,10 +31,10 @@
 COMMENT(-- myeit is like eit but fancier text formatting --)\
 def(myeit)(0)(\
     whenlatex(eit())whenhtml(eit())whenman(eit())whenms(eit())whensgml(eit())\
-    whentxt(USECOUNTER(XXenumcounter)CHAR(41)))\
+    whentxt(eit()CHAR(41)))\
 def(myeitd)(0)(\
     whenlatex(eit())whenhtml(eit())whenman(eit())whenms(eit())whensgml(eit())\
-    whentxt(USECOUNTER(XXenumcounter).))\
+    whentxt(eit().))\
 COMMENT(-- don't want headers for text, USENET headers must come first --)\
 def(myreport)(3)(\
 whentxt(report()()())\
@@ -500,7 +500,6 @@ (http://sunsite.auc.dk/zsh/Patches/)
   substantial.
 
   As a summary of the status:
-  NEWCOUNTER(XXenumcounter)
   enumerate(
   myeit() because of all the options it is not safe to assume a general
      zsh run by a user will behave as if sh or ksh compatible;
@@ -748,7 +747,6 @@ (http://sunsite.auc.dk/zsh/Patches/)
 
   Here is Bart Schaefer's guide to converting csh aliases for zsh.
 
-  SETCOUNTER(XXenumcounter)(0)
   enumerate(
   myeit() If the csh alias references "parameters" (tt(\!:1), tt(\!*) etc.),
      then in zsh you need a function (referencing tt($1), tt($*) etc.).
@@ -1054,7 +1052,6 @@ (http://www.cis.ohio-state.edu/hypertext
 
   This may seem a useful shorthand, but in practice it can have
   unhelpful side effects:
-  SETCOUNTER(XXenumcounter)(0)
   enumerate(
   myeit() Since every variable is in the environment as well as remembered
      by the shell, the memory for it needs to be allocated twice.
@@ -1265,7 +1262,6 @@ (http://www.cis.ohio-state.edu/hypertext
   The problem is that there are two possible ways of autoloading a
   function (see the AUTOLOADING FUNCTIONS section of the zsh manual
   page zshmisc for more detailed information):
-  SETCOUNTER(XXenumcounter)(0)
   enumerate(
   myeit() The file contains just the body of the function, i.e.
      there should be no line at the beginning saying mytt(function foo {)
@@ -1865,7 +1861,6 @@ (for example, there is a function called
 
   Different conditions can also be combined.  There are three levels
   of this (in decreasing order of precedence):
-  SETCOUNTER(XXenumcounter)(0)
   enumerate(
    myeit() multiple square brackets after a single condition give
       alternatives:  for example, mytt(s[foo][bar]) says apply the
-- 
Tanaka Akira

Re: PATCH: FAQ acceptable to yodl 1.31

[Bart Schaefer]

On Oct 28,  6:02am, Tanaka Akira wrote:
> Subject: Re: PATCH: FAQ acceptable to yodl 1.31
> @@ -500,7 +500,6 @@ (http://sunsite.auc.dk/zsh/Patches/)
> @@ -748,7 +747,6 @@ (http://sunsite.auc.dk/zsh/Patches/)
> @@ -1054,7 +1052,6 @@ (http://www.cis.ohio-state.edu/hypertext
> @@ -1265,7 +1262,6 @@ (http://www.cis.ohio-state.edu/hypertext
> @@ -1865,7 +1861,6 @@ (for example, there is a function called

Every one of those lines produces a "malformed patch" error.  What's
happened to this in transit?

Re: PATCH: FAQ acceptable to yodl 1.31

[Tanaka Akira]

In article <991027230256.ZM3969@candle.brasslantern.com>,
  "Bart Schaefer" <schaefer@candle.brasslantern.com> writes:

> Every one of those lines produces a "malformed patch" error.  What's
> happened to this in transit?

Hm. It is caused by the argument '-F^(' for cvs diff.

It is very useful for lisp programs, because the @@ ... @@ line has a
function/macro definition line and it makes easy to find the function
name of the hunk.

Anyway, it is no problem for applying the patch. Don't mind.
I deleted it from ~/.cvsrc just now.
# Recently, I don't develop lisp programs.
-- 
Tanaka Akira

Re: PATCH: FAQ acceptable to yodl 1.31

[Bart Schaefer]

On Oct 28,  6:02am, Tanaka Akira wrote:
} Subject: Re: PATCH: FAQ acceptable to yodl 1.31
}
} I removed XXenumcounter from FAQ.yo.
} This seems to work with Yodl 1.22 and 1.31.16.

I just applied this patch by hand, and no, it doesn't work; the numbers
on the paragraphs are missing:

--- ../../zsh-3.1.6/Etc/FAQ.old Wed Oct 27 12:12:10 1999
+++ ../../zsh-3.1.6/Etc/FAQ     Wed Oct 27 21:09:07 1999
@@ -387,19 +387,19 @@
 
   As a summary of the status:
 
-  1) because of all the options it is not safe to assume a general
+  ) because of all the options it is not safe to assume a general
      zsh run by a user will behave as if sh or ksh compatible;
-  2) invoking zsh as sh or ksh (or if either is a symbolic link to
+  ) invoking zsh as sh or ksh (or if either is a symbolic link to
      zsh) sets appropriate options and improves compatibility (from
      within zsh itself, calling `ARGV0=sh zsh' will also work);
-  3) from version 3.0 onward the degree of compatibility with sh
+  ) from version 3.0 onward the degree of compatibility with sh
      under these circumstances is very high:  zsh can now be used
      with GNU configure or perl's Configure, for example;
-  4) the degree of compatibility with ksh is also high, but a few
+  ) the degree of compatibility with ksh is also high, but a few
      things are missing:  for example the more sophisticated
      pattern-matching expressions are different for versions before
      3.1.3 --- see the detailed list below;
-  5) also from 3.0, the command `emulate' is available: `emulate
+  ) also from 3.0, the command `emulate' is available: `emulate
      ksh' and `emulate sh' set various options as well as changing the
      effect of single-letter option flags as if the shell had been
      invoked with the appropriate name.  Including the commands

(and so on for other hunks).

I'm afraid this is just a case of "you have to be running the latest yodl."

-- 
Bart Schaefer                                 Brass Lantern Enterprises
http://www.well.com/user/barts              http://www.brasslantern.com

Re: PATCH: FAQ acceptable to yodl 1.31

[Tanaka Akira]

In article <991028041346.ZM4196@candle.brasslantern.com>,
  "Bart Schaefer" <schaefer@candle.brasslantern.com> writes:

> I just applied this patch by hand, and no, it doesn't work; the numbers
> on the paragraphs are missing:

The patch works for me with yodl-1.22 as:

| Z(2):akr@is27e1u11% rm FAQ
| Z(2):akr@is27e1u11% diff -u ../../zsh-3.1.6-bart-7/Etc/FAQ.yo FAQ.yo
| --- ../../zsh-3.1.6-bart-7/Etc/FAQ.yo   Sun Oct  3 14:11:16 1999
| +++ FAQ.yo      Thu Oct 28 05:46:15 1999
| @@ -31,10 +31,10 @@
|  COMMENT(-- myeit is like eit but fancier text formatting --)\
|  def(myeit)(0)(\
|      whenlatex(eit())whenhtml(eit())whenman(eit())whenms(eit())whensgml(eit())\
| -    whentxt(USECOUNTER(XXenumcounter)CHAR(41)))\
| +    whentxt(eit()CHAR(41)))\
|  def(myeitd)(0)(\
|      whenlatex(eit())whenhtml(eit())whenman(eit())whenms(eit())whensgml(eit())\
| -    whentxt(USECOUNTER(XXenumcounter).))\
| +    whentxt(eit().))\
|  COMMENT(-- don't want headers for text, USENET headers must come first --)\
|  def(myreport)(3)(\
|  whentxt(report()()())\
| @@ -49,7 +49,7 @@
|  mydit(Archive-Name:) unix-faq/shell/zsh
|  mydit(Last-Modified:) 1999/07/30
|  mydit(Submitted-By:) email(pws@ibmth.df.unipi.it (Peter Stephenson))
| -mydit(Version:) $Id: FAQ.yo,v 1.6 1999/10/03 05:11:16 schaefer Exp $
| +mydit(Version:) $Id: FAQ.yo,v 1.1.1.12 1999/10/27 19:36:49 akr Exp $
|  mydit(Posting-Frequency:) Monthly
|  mydit(Copyright:) (C) P.W. Stephenson, 1995--1999 (see end of document)
|  )
| @@ -747,7 +747,6 @@
|  
|    Here is Bart Schaefer's guide to converting csh aliases for zsh.
|  
| -  SETCOUNTER(XXenumcounter)(0)
|    enumerate(
|    myeit() If the csh alias references "parameters" (tt(\!:1), tt(\!*) etc.),
|       then in zsh you need a function (referencing tt($1), tt($*) etc.).
| @@ -1053,7 +1052,6 @@
|  
|    This may seem a useful shorthand, but in practice it can have
|    unhelpful side effects:
| -  SETCOUNTER(XXenumcounter)(0)
|    enumerate(
|    myeit() Since every variable is in the environment as well as remembered
|       by the shell, the memory for it needs to be allocated twice.
| @@ -1264,7 +1262,6 @@
|    The problem is that there are two possible ways of autoloading a
|    function (see the AUTOLOADING FUNCTIONS section of the zsh manual
|    page zshmisc for more detailed information):
| -  SETCOUNTER(XXenumcounter)(0)
|    enumerate(
|    myeit() The file contains just the body of the function, i.e.
|       there should be no line at the beginning saying mytt(function foo {)
| @@ -1864,7 +1861,6 @@
|  
|    Different conditions can also be combined.  There are three levels
|    of this (in decreasing order of precedence):
| -  SETCOUNTER(XXenumcounter)(0)
|    enumerate(
|     myeit() multiple square brackets after a single condition give
|        alternatives:  for example, mytt(s[foo][bar]) says apply the
| zsh: exit 1     diff -u ../../zsh-3.1.6-bart-7/Etc/FAQ.yo FAQ.yo
| Z(2):akr@is27e1u11% cd Etc                                          
| Z(2):akr@is27e1u11% make                                            
| cd . && yodl2txt FAQ.yo && mv -f FAQ.txt FAQ
| YODL to plain ASCII Converter V1.22 (1996-1997)
| 
| Yodl is processing a(n) report
| Running post-processor /app/yodl-1.22/lib/yodl/yodl2txt-post..
| Z(2):akr@is27e1u11% diff -u ../../zsh-3.1.6-bart-7/Etc/FAQ FAQ      
| --- ../../zsh-3.1.6-bart-7/Etc/FAQ      Mon Oct 18 01:27:07 1999
| +++ FAQ Thu Oct 28 13:33:55 1999
| @@ -2,7 +2,7 @@
|  Archive-Name: unix-faq/shell/zsh
|  Last-Modified: 1999/07/30
|  Submitted-By: pws@ibmth.df.unipi.it (Peter Stephenson)
| -Version: $Id: FAQ.yo,v 1.6 1999/10/03 05:11:16 schaefer Exp $
| +Version: $Id: FAQ.yo,v 1.1.1.12 1999/10/27 19:36:49 akr Exp $
|  Posting-Frequency: Monthly
|  Copyright: (C) P.W. Stephenson, 1995--1999 (see end of document)
|  
| zsh: exit 1     diff -u ../../zsh-3.1.6-bart-7/Etc/FAQ FAQ

Hm. Anyone reproduce the problem?
-- 
Tanaka Akira