Re: Links into HTML page would be great

[Ingo Schwarze <schwarze@usta.de>]

Hi Jan,

Jan Stary wrote on Tue, Mar 14, 2017 at 10:39:12AM +0100:

> in e.g.
> http://man.openbsd.org/vmctl.8#create
> the mouseover is "Cm", and it's "Fl" for the options,
> and similarly for "Sx", "Xr" and the others.
> 
>   <dt class="It-tag" style="margin-left: -6.60ex;"><a class="selflink"
>   href="#create"><b class="Cm" title="Cm" id="create">create</b></a>
> 
> That seems a bit odd to display.

What is odd about that?

> Is that intended?

Yes.

> I get why it's the class, but why is it the title?

Because semantic markup is the whole point of the mdoc(7) language,
and not communicating the semantics to the user is a shame and a waste?

For example, in a section 3 manual, italic font might mean a function
type, a variable type, a function argument, a variable name, a path
name, stress emphasis and so on...  Anywhere, typewriter font might
mean a preprocessor constant, an error constant, an environment
variable...  It is obviously useful to be able to distinguish these
possibilities without guessing, or isn't it?

Besides, you can search for these macros keys with apropos(1),
so getting familiar with them over time is very useful.

Besides, OpenBSD is a developer-oriented system.  We enncourage
users to improve the system and send patches.  Some become developers,
and there is no other way of becoming a developer.  Getting familiar
with the macros is not just useful to better understand the content,
and to use search facilities efficiently, but also to lower the
barrier for sending patches.

Yours,
  Ingo
--
 To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv