emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Writing manuals


From: Eli Zaretskii
Subject: Re: Writing manuals
Date: Sat, 04 Sep 2021 18:54:02 +0300

> From: Yuan Fu <casouri@gmail.com>
> Date: Sat, 4 Sep 2021 08:48:36 -0700
> Cc: emacs-devel@gnu.org
> 
> >> And, IIUC nodes are uniquely named in a manual, I think maybe it’s not a 
> >> good idea to use generic node names like “Language Definition”, “Pattern 
> >> Matching”, etc
> > 
> > Why not?  Once again, if we ever support other similar libraries, we
> > should strive to have similar facilities described in the same nodes,
> > not in separate nodes.
> 
> Not general in that sense, but in the sense that some other Emacs feature 
> unrelated to parsing could need that name. For example, pcase is a kind of 
> “Pattern Matching”, an input method could have a “Language Definition”.

I wouldn't worry about that, at least not now.  "Pattern", "matching",
"language", etc. are terms that are overloaded many times, and if we'd
worry about this, we'd be unable to come up with useful node names.
But you could say "Pattern Matching with Nodes" and "Programming
Language Definitions" instead, if you think that's better.



reply via email to

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