From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout-kit-01.scc.kit.edu (scc-mailout-kit-01.scc.kit.edu [129.13.231.81]) by fantadrom.bsd.lv (OpenSMTPD) with ESMTP id e5bad36e for ; Tue, 14 Mar 2017 12:17:18 -0500 (EST) Received: from asta-nat.asta.uni-karlsruhe.de ([172.22.63.82] helo=hekate.usta.de) by scc-mailout-kit-01.scc.kit.edu with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (envelope-from ) id 1cnq4S-0002gE-Qo; Tue, 14 Mar 2017 18:17:17 +0100 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.77) (envelope-from ) id 1cnq4R-0000E8-2W; Tue, 14 Mar 2017 18:17:15 +0100 Received: from athene.usta.de ([172.24.96.10]) by donnerwolke.usta.de with esmtp (Exim 4.84_2) (envelope-from ) id 1cnq4Q-0000uV-Uq; Tue, 14 Mar 2017 18:17:15 +0100 Received: from localhost (athene.usta.de [local]) by athene.usta.de (OpenSMTPD) with ESMTPA id f9366131; Tue, 14 Mar 2017 18:17:14 +0100 (CET) Date: Tue, 14 Mar 2017 18:17:14 +0100 From: Ingo Schwarze To: Jan Stary Cc: discuss@mdocml.bsd.lv Subject: Re: Links into HTML page would be great Message-ID: <20170314171714.GA19750@athene.usta.de> References: <8ffc686a-f898-4952-ae6f-3b8881469f17@thomas-guettler.de> <20170312180832.GE69791@athene.usta.de> <20170312193940.GA91520@athene.usta.de> <0dbf9b44-499d-dabc-f759-17c5a0f2f6da@thomas-guettler.de> <20170313095627.GA97043@www.stare.cz> <20170314093912.GA15549@www.stare.cz> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20170314093912.GA15549@www.stare.cz> User-Agent: Mutt/1.6.2 (2016-07-01) 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. > >
href="#create">create > > 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