* bug#13502: 24.3.50; bad formatting in recent NEWS?
@ 2013-01-19 22:47 Drew Adams
2013-01-20 2:42 ` Chong Yidong
0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2013-01-19 22:47 UTC (permalink / raw)
To: 13502
The longest is this one (87 chars):
machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert
"~/.my_smtp_tls.cert"
There are also entries whose first line (a sentence) does not end in a
period. And there are entries whose first line is not a sentence, and
is continued over subsequent lines.
All of these seem to contradict past NEWS formatting, but I don't know
where the rules for formatting NEWS are defined, so I cannot tell
whether they are strictly wrong or just unusual. The last one certainly
works against the use of Outline mode to some extent.
In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600)
of 2013-01-18 on ODIEONE
Bzr revision: 111548 sdl.web@gmail.com-20130118182218-6ywd47qsbnow6nsg
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
`configure --with-gcc (4.7) --no-opt --enable-checking --cflags
-IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#13502: 24.3.50; bad formatting in recent NEWS?
2013-01-19 22:47 bug#13502: 24.3.50; bad formatting in recent NEWS? Drew Adams
@ 2013-01-20 2:42 ` Chong Yidong
2013-01-20 4:37 ` Drew Adams
0 siblings, 1 reply; 3+ messages in thread
From: Chong Yidong @ 2013-01-20 2:42 UTC (permalink / raw)
To: Drew Adams; +Cc: 13502-done
"Drew Adams" <drew.adams@oracle.com> writes:
> The longest is this one (87 chars):
>
> machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert
> "~/.my_smtp_tls.cert"
It should be incredibly obvious why this line is an OK exception.
As for any other lines, they will be cleaned up when it comes time to
edit the NEWS file in preparation for the 24.4 pretest. No point filing
a bug about this kind of thing. Closing.
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#13502: 24.3.50; bad formatting in recent NEWS?
2013-01-20 2:42 ` Chong Yidong
@ 2013-01-20 4:37 ` Drew Adams
0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2013-01-20 4:37 UTC (permalink / raw)
To: 'Chong Yidong'; +Cc: 13502-done
> > The longest is this one (87 chars):
> >
> > machine smtp.whatever.foo port 25 key "~/.my_smtp_tls.key" cert
> > "~/.my_smtp_tls.cert"
>
> It should be incredibly obvious why this line is an OK exception.
In spite of your hyperbole ("incredibly obvious", indeed), there is no need for
this line to be an exception. It is too long only because you have used
fictitious names that are too long. Those names do not explain anything, in any
case, and they need not be that long.
In addition, the text is incorrect. It is "incredibly obvious" that it is NOT
true that "you need to put" that line "in your ~/authinfo file instead." It is
no doubt 100% wrong that you should use that literal text. What should be said
is something like this:
If you had that set then you need to put
machine MACHINE port PORT key KEYFILE cert CERTFILE
where MACHINE is..., PORT is..., KEYFILE is..., and CERTFILE
is.... [Specification still missing.]
For example, MACHINE could be smtp.whatever.foo, PORT could
be 25, KEYFILE could be "~/.my_smtp_tls.key", and CERTFILE
could be "~/.my_smtp_tls.cert".
No long lines needed, and incorrect and misleading statement removed.
> As for any other lines, they will be cleaned up when it comes time to
> edit the NEWS file in preparation for the 24.4 pretest. No
> point filing a bug about this kind of thing.
Quite a pretension. What happened to such cleanup during the 24.3 pretest? Or
24.2? Same problems - same long lines even; no such cleanup.
> Closing.
Improvident.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2013-01-20 4:37 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-01-19 22:47 bug#13502: 24.3.50; bad formatting in recent NEWS? Drew Adams
2013-01-20 2:42 ` Chong Yidong
2013-01-20 4:37 ` Drew Adams
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).