| Newsgroups |
gmane.linux.lfs.beyond.devel |
| Message-ID |
<[email protected]> |
On Tue, 2025-07-22 at 19:46 +0200, Rainer Fiebig wrote:
> Am 22.07.25 um 14:41 schrieb Xi Ruoyao ([email protected] via blfs-
> dev
> Mailing List):
> > On Tue, 2025-07-22 at 12:34 +0200, Rainer Fiebig wrote:
> > > In order to improve readability, I think that double quotes should
> > > be
> > > used to delimit the test-suite-message in this sentence:
> > >
> > > [...] will bail out early with messages like net/ftp is not found.
> > >
> > > This would be better (IMO):
> > >
> > > [...] will bail out early with messages like "net/ftp is not
> > > found".
> >
> > The problem with quote here is per the American English grammar the
> > punctuation should be inside the quote, but the computer doesn't
> > actually output a punctuation.
> You probably mean that the message doesn't end with a period.
> Alright,
> I see your point. But if said grammar rules require the period to be
> within the quote (and you want to strictly adhere to those rules),
> then
>
> "net/ftp is not found."
>
> would still be correct and still better readable than the current
> form.
Besides the grammar issue IMO docbook already provides <computeroutput>
to indicate "Data, generally text, displayed or presented by a
computer," so we should just use it to indicate a text presented by the
computer.
And if it's so unreadable, all occurrences of <computeroutput> would be
unreadable. Then we should change the CSS like how Bruce suggested
instead of change the entire book (and debate about where the period
should be).
>
> >
> > So here we use <computeroutput> which should be rendered in a different
> > style than the normal texts. If your browser fails to render them in
> > different styles it's either buggy or misconfigured. Even Lynx uses
> > different colors.
> I think that my browser (Firefox) is OK. But perhaps my eyes are "buggy
> or misconfigured?" Look, I just stumbled across this thing and my
> suggestion was intended as a constructive contribution. But if such are
> not wanted (anymore) or are perceived as unduly criticism, it's probably
> better to waste my time in more rewarding ways.
The browser can be misconfigured, by making something in /etc/fonts
wrong. In the past there are people who used some broken font and read
"-O0" as "-OO."
--
Xi Ruoyao <[email protected]>
--
http://lists.linuxfromscratch.org/sympa/info/blfs-dev
Unsubscribe: See the above information page