Date: Sat, 27 May 2000 16:52:20 +0000 From: Nik Clayton <nik@freebsd.org> To: Jim Mock <jim@luna.cdrom.com> Cc: Mark Ovens <mark@dogma.freebsd-uk.eu.org>, freebsd-doc@freebsd.org Subject: Re: docs/18789: [PATCH] bad link in the handbook Message-ID: <20000527165220.B46877@kilt.nothing-going-on.org> In-Reply-To: <20000524164945.A717@luna.cdrom.com>; from jim@luna.cdrom.com on Wed, May 24, 2000 at 04:49:45PM -0700 References: <200005242240.PAA26509@freefall.freebsd.org> <20000525000150.I232@parish> <20000524163256.A460@luna.cdrom.com> <20000525004113.J232@parish> <20000524164945.A717@luna.cdrom.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, May 24, 2000 at 04:49:45PM -0700, Jim Mock wrote:
> > No, I just use the URL
> > file:///usr/share/doc/en/books/handbook/index.html in Netscape.
>
> Ah ok, that's why :-) Netscape doesn't like if you leave off the
> index.html when browsing a file directly.
And so it shouldn't. If you leave a filename off then it shows you the
directory listing.
S'my cockup. As far as possible our documentation set shouldn't assume
there's a web server running, as (IMHO), that's an unacceptable burden
to place on someone who just wants to browse the documentation locally.
I see Jim's closed this PR without making a change, so I'll do so. But
for reference, Mark's patch included a whitespace change, which makes
things a little harder for the translation teams, so I haven't included
that part.
Note that I've no objection to us using additional features that webservers
can provide where necessary, I just don't want to depend on them where we
can avoid it.
For example, should someone feel like extending the stylesheets so that
<citerefentry><refentrytitle>ls</><manvolnum>1</></>
generates
<a href="http://www.freebsd.org/cgi/man.cgi?ls">ls(1)</a>;
in the HTML version that'd be great (hint, hint), as long as the code to
do that is wrapped inside something like
<![ %use-external-links; [
...
]]>
or similar (or, better still, was sufficiently modular that people could
plug in their own URLs using some sort of format string, so we could submit
it back to Norm).
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000527165220.B46877>