From owner-freebsd-doc Tue Jul 25 6:55:52 2000 Delivered-To: freebsd-doc@freebsd.org Received: from raditex.se (gandalf.raditex.se [192.5.36.18]) by hub.freebsd.org (Postfix) with ESMTP id 2C35F37B5AB for ; Tue, 25 Jul 2000 06:55:47 -0700 (PDT) (envelope-from kaj@raditex.se) Received: (from kaj@localhost) by raditex.se (8.9.3/8.9.3) id PAA81340; Tue, 25 Jul 2000 15:55:34 +0200 (CEST) (envelope-from kaj@raditex.se) X-Authentication-Warning: frodo.sickla.raditex.se: kaj set sender to kaj@raditex.se using -f To: Jim Mock Cc: freebsd-doc@FreeBSD.ORG Subject: Re: docs/20130: Entities missing from doc/share/sgml/man-refs.ent References: <200007240550.WAA15046@freefall.freebsd.org> From: Rasmus Kaj Cc: Rasmus Kaj Organization: Raditex AB - http://Raditex.se/ X-Face: M9cR~WYav<"fu%MaslX0`43PAYY?uIsM8[#E(0\Xuy9rj>4gE\h3jm.7DD?]R8*^7T\o&vT U@[53Dwkuup4[0@gw#~kyu>`unH?kVj9CJa02(h>Ki\+i=%rn%sDf^KC.!?IHkKjMAbkd\jgmphp^' d|Q;OeXEAhq?ybGqOs1CHb6TJT42'C`Krnk61//AOfXtNjj/t'`5>Vw0QX!dKfOL$.f+S"LIuwR<;I Z0Qnnx(F^F]o@*V%TUtEV'1Z[TkOl^FFV9Z~A[b19%}uP*,huCU Date: 25 Jul 2000 15:55:33 +0200 In-Reply-To: Jim Mock's message of "Sun, 23 Jul 2000 22:50:01 -0700 (PDT)" Message-ID: <848zuqfh62.fsf@frodo.sickla.raditex.se> Lines: 38 User-Agent: Gnus/5.0806 (Gnus v5.8.6) XEmacs/20.4 (Emerald) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >>>>> "JM" == Jim Mock writes: >> People writing documentation for the FDP are supposed to use entities >> in the form &man.foo.1; to refer to system commands etc. >> /usr/share/doc/man contains about 3500 manpages (entities needed), >> man-refs.ent contains 220 entities. JM> I think the major reason for this is that a) stuff that's needed can be JM> added when a document is written, and b) it keeps the file size down. JM> If we add entities for every single man page, chances are, we'll never JM> use at least half of them, so it's kind of overkill to have a huge, JM> bloated man-refs.ent file when it's not necessary. I use entities like &foldoc.foo; to reference to words (foo) in Foldoc (free online dictionary of computing). Currently I have these listed pretty much like the &man.foo.n; entities, but I'd like to have them created automatically. Something like this (in a directory containing sgml stuff) lists the needed entities. find . -name '*.sgml' | xargs grep '&foldoc\.' | sed -e "s#;#;\\ #g" -e 's#^.*\&foldoc\.#foldoc.#' | grep ^foldoc | sort -u | sed -e 's#;##' This gives me a list of entities i need. Adding a further sed command: sed -e 's#foldoc\.\(.*\)#\1"># Gives me the entity definitions I need, in no practically measurable time. However, the pages I do this on is less than 200kb sgml, so it might not be practically possible to do it on the entire documentation project, at least not for each build ... -- Rasmus Kaj -------------------- rasmus@kaj.se - http://Raditex.se/~kaj/ \ If you think I'm talking about the future you're living in the past \------------------------------------------------- http://Raditex.se/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message