From owner-freebsd-doc@FreeBSD.ORG Tue Feb 26 12:49:40 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 70E0519E for ; Tue, 26 Feb 2013 12:49:40 +0000 (UTC) (envelope-from gkeramidas@gmail.com) Received: from mail-we0-x232.google.com (mail-we0-x232.google.com [IPv6:2a00:1450:400c:c03::232]) by mx1.freebsd.org (Postfix) with ESMTP id EAE01FF for ; Tue, 26 Feb 2013 12:49:39 +0000 (UTC) Received: by mail-we0-f178.google.com with SMTP id x48so3359537wey.23 for ; Tue, 26 Feb 2013 04:49:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:date:from:to:subject:message-id:mime-version :content-type:content-disposition; bh=QIZp+4gCDQvfYwtBF2ajX+ZNYb/xenVlzt/4JhNPkRA=; b=f2d1U4avhzB6QX4V2djiXQ/7CT9zneQ2LWVMHyzHLxM/CkMER4PzkQaSyWVVQyu8as cVMmCQceME8DVOut1x4KUoQVaWdxsTLzhpCs9AbqEtTRBYkmtLxnVeO0ZHZjLwiX7TGT xcKu+AutVMlaxMI5TOj3tToATyIn2iUe0YD8N5YJph8cb94Ml54f1PWl0iEffYRUT3qo z/QBa5fhfe130l2z1vpJJn4pMwf+71jrv/QQBuFn4fCbcML8221lLyadjqMcCpAb51yy wALHBhomB0YChUrCnsRINkLb9+z23XXam17FCzvmE4Lf/PnyzhsKbB8RDyVvapeDqxwH wD4w== X-Received: by 10.181.12.103 with SMTP id ep7mr19083635wid.12.1361882979090; Tue, 26 Feb 2013 04:49:39 -0800 (PST) Received: from saturn (217-162-217-29.dynamic.hispeed.ch. [217.162.217.29]) by mx.google.com with ESMTPS id fx5sm1725902wib.11.2013.02.26.04.49.37 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Tue, 26 Feb 2013 04:49:37 -0800 (PST) Sender: Giorgos Keramidas Date: Tue, 26 Feb 2013 13:49:34 +0100 From: Giorgos Keramidas To: freebsd-doc@freebsd.org Subject: Do we care for manpage links in elements? Message-ID: <20130226124932.GA7258@saturn> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="HcAYCG3uE/tztfnV" Content-Disposition: inline X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project <freebsd-doc.freebsd.org> List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe> List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc> List-Post: <mailto:freebsd-doc@freebsd.org> List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help> List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>, <mailto:freebsd-doc-request@freebsd.org?subject=subscribe> X-List-Received-Date: Tue, 26 Feb 2013 12:49:40 -0000 --HcAYCG3uE/tztfnV Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Hi everyone, I just noticed that in all the places where a chapter <title> includes a &an.xxx.section; entity the rendering in HTML output sucks a bit. Note how there are two separate links in the 'Using rc(8) Under FreeBSD' title in the following screenshot: http://people.freebsd.org/~keramida/rc8-title-link.png The <title> itself becomes an <a>...</a> element, but when a &man.xxx.y; macro is included in the title, the final rendering becomes: <a link="foo"> some text <a href="manpage link">manpage name</a> maybe more text </a> The embedded <a> terminates the first link, and the first </a> terminates the second link, so we end up with the broken rendering pf the screenshot and two _different_ links in the same sentence. Is there any way to automatically detect this and translate the embedded <a> element that &man.xxx.y; generates to something harmless, like <span>? If not, do we really care for &man.xxx.y; in titles, or should we just replace them with plain text? --HcAYCG3uE/tztfnV Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iEYEARECAAYFAlEsr1wACgkQ1g+UGjGGA7YX8ACgqJgE0IWZLlAy0E9tqw88HLqn J4AAn3znpB0IxLTv0GHJAizndnkil1vL =Ooln -----END PGP SIGNATURE----- --HcAYCG3uE/tztfnV--