Bug 84317 - fdp-primer doesn't show class=USERNAME distinctively
Summary: fdp-primer doesn't show class=USERNAME distinctively
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-07-29 19:40 UTC by Gary W. Swearingen
Modified: 2014-06-03 00:41 UTC (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Gary W. Swearingen 2005-07-29 19:40:25 UTC
At least on plain-jane Mozilla 1.7.8 (linux) installed from port recently,
this page
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/preface-conventions.html
has an example of "User and group names", namely "root", which looks the same
as the other text surrounding it.  At least as an example, it should
look different.

Viewing the page source, I see:    <tt class="USERNAME">root</tt> 

If this has something to do with "style-sheets", we need some instructions on
how to set that up; I and many other users know next-to-nothing about it.

How-To-Repeat: n/a
Comment 1 Marc Fonvieille freebsd_committer freebsd_triage 2005-07-29 19:59:46 UTC
hmm, weird cause the rendering is Ok here with Mozilla 1.7.7 (FreeBSD),
did you try with other versions or browsers?

Marc
Comment 2 Giorgos Keramidas freebsd_committer freebsd_triage 2005-07-29 20:17:05 UTC
On 2005-07-29 19:00, Marc Fonvieille <blackend@freebsd.org> wrote:
>> At least on plain-jane Mozilla 1.7.8 (linux) installed from port recently,
>> this page
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/preface-conventions.html
>> has an example of "User and group names", namely "root", which looks the same
>> as the other text surrounding it.  At least as an example, it should
>> look different.
>
>  hmm, weird cause the rendering is Ok here with Mozilla 1.7.7 (FreeBSD),
>  did you try with other versions or browsers?

FYI,

It is different from the surrounding text.  The surrounding text is
"plain text" but the "root" word is displayed with a monospaced font.

In small sizes, this is not very obvious, but if you zoom in the larger
character box size and the constant width of the characters in the
"root" word is more apparent.

The specific serif/sand-serif and monospaced fonts that Mozilla (or any
browser) is configured to use may also play an important role in making
the different easier to see.

For instance, using "Arial" as the sans-serif font and "Courier" as the
monospaced font makes the difference *much* more visible than say a
setup where the sans-serif font is "Verdana" and the monospaced font is
"Andale Mono".
Comment 3 Gary W. Swearingen 2005-07-29 21:13:32 UTC
Marc Fonvieille <blackend@FreeBSD.org> writes:
>
> hmm, weird cause the rendering is Ok here with Mozilla 1.7.7 (FreeBSD),
> did you try with other versions or browsers?

No, I have no others installed.  Maybe some doc@ readers will report
whether "root" looks distinct in the "User and group names" line at

http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/preface-conventions.html
Comment 4 Ceri Davies 2005-07-31 14:26:43 UTC
On 29 Jul 2005, at 20:20, Gary W. Swearingen wrote:
>  Marc Fonvieille <blackend@FreeBSD.org> writes:
>
>>
>> hmm, weird cause the rendering is Ok here with Mozilla 1.7.7  
>> (FreeBSD),
>> did you try with other versions or browsers?
>>
>
>  No, I have no others installed.  Maybe some doc@ readers will report
>  whether "root" looks distinct in the "User and group names" line at
>
>  http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/ 
> preface-conventions.html

It looks different here on every browser I have (Firefox, Camino,  
Safari, Internet Explorer).  That's because of the browser's default  
style for <tt> though, as docbook.css has nothing for either the tt  
element or the username class.

Perhaps we should be specifying a font family in the stylesheet?

Ceri
Comment 5 Warren Block freebsd_committer freebsd_triage 2014-06-03 00:41:29 UTC
Browsers have changed greatly in the last nine years, and the documentation toolchain has changed twice as well.  Cursory tests show the root user name appears in a monospaced font as intended.