Date: 18 Aug 1999 17:43:19 -0700 From: asami@freebsd.org (Satoshi - Ports Wraith - Asami) To: Nik Clayton <nik@freebsd.org> Cc: doc@freebsd.org, doc-jp@jp.freebsd.org Subject: Re: Default FDP docs installation directory? Message-ID: <vqcbtc4vbvc.fsf@silvia.hip.berkeley.edu> In-Reply-To: Nik Clayton's message of "Thu, 19 Aug 1999 00:57:35 %2B0100" References: <19990818121931.A4266@kilt.nothing-going-on.org> <vqcr9l0eol7.fsf@silvia.hip.berkeley.edu> <19990819005735.C83680@catkin.nothing-going-on.org>
next in thread | previous in thread | raw e-mail | index | archive | help
* From: Nik Clayton <nik@freebsd.org> * It's an opportunity -- it's not something we *have* to do. I'm posting Oh yeah? You said you have just committed Makefiles that already install stuff into your preferred location. > The Makefile's I've committed so far install the docs in to > > /usr/local/share/doc/fdp/<lang>/<type>/<doc name>/ * this for wider discussion because we now have an implementation that makes * it fairly trivial to actually make the change. * * If this had been discussed before the repo move, we would have had a nice * long thread discussing the various pros and cons, and no conclusion would * have emerged, because no one could try out the various options to see * what happens. Why do I need to try it out? I can see everything very clearly by just the examples you give below, thank you. * The top level of that tree looks like * * en_US.ISO_8859-1/ es_ES.ISO_8859-1/ ja/ * ru_RU.KOI8-R/ zh_TW.Big5/ * * and includes the compatability symlinks (which I haven't shown above). * * I don't think that's terribly informative on their own, which is why I * think dropping those directories straight in to /usr/share/doc/ or * /usr/local/share/doc/ is a bad idea. It looks very informative to me, if kept in /usr/share/doc. In fact, the "ja" part looks exactly like before. :) And you said the English docs are going to move to en_<whatever>, which is also exactly what happens. * > fdp is even uglier, and I can't recall anyone other than you using * > that particular acronym. * * Alternatives? "docproj"? "doc-proj"? "doc-project"? Something better? I don't think we need a subdirectory. * That will lead to /usr/share/doc/en_US.ISO_8859-1/ * es_ES.ISO_8859-1/ * ja/ * papers/ * psd/ * ru_RU.KOI8-R * smm/ * usd/ * zh_TW.Big/ * * and so on. We can do it, but I'm not convinced it's a good idea. Maybe move papers, psd etc. to the English subdirectory too? * I stress that doesn't mean we won't do it, just that I don't think it's a * good idea. However, if the consensus on this list is that it's a good * idea then we can do that. * * Of course, it would also be possible during "make install" time to * designate one language as the default, which could lead to * * /usr/share/doc/articles@ -> en_US.ISO_8859-1/articles/ * books@ -> en_US.ISO-8859-1/books/ * en_US.ISO_8859-1 * es_ES.ISO_8859-1/ * ja/ * papers/ * psd/ * ru_RU.KOI8-R * smm/ * usd/ * zh_TW.Big/ * * which might be more palatable. That's fine for me too. See, the point here is that non-English users have been using /usr/share/doc/<lang>/ for years to refer to their docs. They're used to it. Now it's the English speakers' turn to get used to it. Just because the English part of docproj moved doesn't mean you have to yank the chain to drag whole non-US/UK part of the world along with you. :) Satoshi 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?vqcbtc4vbvc.fsf>