From owner-freebsd-doc Thu May 30 22:46:25 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id 218E837B403; Thu, 30 May 2002 22:46:18 -0700 (PDT) Received: from pittgoth.com ([192.168.1.2]) by pittgoth.com (8.12.3/8.12.3) with ESMTP id g4V5kFFP000565; Fri, 31 May 2002 01:46:16 -0400 (EDT) (envelope-from darklogik@pittgoth.com) Message-ID: <3CF738D3.4070205@pittgoth.com> Date: Fri, 31 May 2002 01:48:19 -0700 From: Tom Rhodes User-Agent: Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010628 X-Accept-Language: en-us MIME-Version: 1.0 To: Nik Clayton Cc: Tom Rhodes , Chris Pepper , keramida@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: (man page || manpage) => manual page References: <20020529214746.GA67346@hades.hell.gr> <20020529183350.314b0f2a.trhodes@FreeBSD.org> <20020530081201.M64264@canyon.nothing-going-on.org> Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Nik Clayton wrote: >On Wed, May 29, 2002 at 06:33:50PM -0400, Tom Rhodes wrote: > >>Entities allow you to assign a name to some chunk of data, and >> >[...] > >>file. >> > >This bit's correct. > >>Our man tags are custom to the FreeBSD project, taking the user/reader >>to our version of the specified manual page. Many manual pages differ from >>operating system to operating system (for instance, drivers) and this >>lets us define a link to a man page search engine... >> >>This also differs in fact that, the man entity is not standard in >>html or DocBook for that matter (unless you define it), unlike the >>usual: © ™ that works in HTML and DocBook (others?) >> > >This bit isn't. > >The various entities that we use (&man., &a., &os., &rel., &gui., ...) >are purely to cut down the amount of typing the document author has to >do, and to try and ensure consistency between different documents. It's >got nothing to do with any links that might be automatically generated >in the documentation. > >N > Well, its sort of correct in the fact that, you can define your own entities... But I did get why the docproj uses em wrong ;) -- Tom (who's fighting with his new laptop and may be difficult to reach) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message