unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* doc string of print-quoted
@ 2008-04-14 16:54 Drew Adams
  2008-04-14 19:42 ` Stefan Monnier
  0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2008-04-14 16:54 UTC (permalink / raw)
  To: bug-gnu-emacs; +Cc: submit


The doc string:
 
 "Non-nil means print quoted forms with reader syntax.
  I.e., (quote foo) prints as 'foo, (function foo) as #'foo, and backquoted
  forms print as in the new syntax."
 
The last part, "as in the new syntax", is unclear and
inappropriate. What is "the new syntax"?

Doc should always document the current state of the software, and it
should not use terms such as "currently" or "new" in doing so.
 
("As the present now will later be past, the order is rapidly fadin'.
And the first one now will later be last, for the times they are
a-changin'.")


In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600)
 of 2007-06-02 on RELEASE
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'
 





^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: doc string of print-quoted
  2008-04-14 16:54 doc string of print-quoted Drew Adams
@ 2008-04-14 19:42 ` Stefan Monnier
  0 siblings, 0 replies; 2+ messages in thread
From: Stefan Monnier @ 2008-04-14 19:42 UTC (permalink / raw)
  To: Drew Adams; +Cc: submit, bug-gnu-emacs

>  "Non-nil means print quoted forms with reader syntax.
>   I.e., (quote foo) prints as 'foo, (function foo) as #'foo, and backquoted
>   forms print as in the new syntax."
 
> The last part, "as in the new syntax", is unclear and
> inappropriate. What is "the new syntax"?

> Doc should always document the current state of the software, and it
> should not use terms such as "currently" or "new" in doing so.
 
> ("As the present now will later be past, the order is rapidly fadin'.
> And the first one now will later be last, for the times they are
> a-changin'.")

Indeed, I've just removed the last part, thanks,


        Stefan




^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2008-04-14 19:42 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2008-04-14 16:54 doc string of print-quoted Drew Adams
2008-04-14 19:42 ` Stefan Monnier

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).