[bug #57944] doc/groff.texi: expand .de documentation

[G. Branden Robinson]

Update of bug #57944 (project groff):

                Severity:                1 - Wish => 3 - Normal             
                  Status:                    None => In Progress            
             Assigned to:                    None => gbranden               

    _______________________________________________________

Follow-up Comment #2:


[comment #1 comment #1:]
> [comment #0 original submission:]
> > CSTR #54 made this clear: it included the sentence (using "yy"
> > in place of "end") "Input lines are copied in copy mode until
> > the definition is terminated by a line beginning with .yy,
> > whereupon the macro yy is called."
> 
> Commit 07edefd1
<http://git.savannah.gnu.org/cgit/groff.git/commit/?id=07edefd1> adds to the
info manual: "Alternatively, 'end' names a macro which, upon being
subsequently called, ends the definition of 'name'."
> 
> This addresses this part of the bug.  To me, the CSTR #54 wording is a
little clearer; it made the order of events immediately clear to me, while I
had to read the new sentence a couple times before fully understanding it. 
But the new sentence ultimately does say the same thing as the CSTR #54 one,
so this may be merely a limitation of my brain.

No, I think you're right, and I in fact had not absorbed that fact.  This
quick experiment did not turn out as I expected.


.de bar
.  if d foo .tm foo is defined
..
.de foo bar
.  nop
.bar
foo is defined


I try _not_ to write new documentation with existing documentation open before
me, to avoid the risk of plagiarism, and also because thinking things through
carefully myself helps me to learn the topic better.

On the other hand, it also reveals deficiencies in my knowledge.

I'll kick this back up to normal because I think I have made the manual
erroneous in this respect.  I'll have to recast.

Thanks for the quick spotting, Dave.

    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?57944>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/