Date: Tue, 27 Nov 2001 20:19:30 +0200 From: Alexey Zelkin <phantom@freebsd.org> To: wosch@freebsd.org, nik@freebsd.org, doc@freebsd.org Subject: tidy(1) related modifications [request for objections] Message-ID: <20011127201930.A20801@ark.cris.net>
next in thread | raw e-mail | index | archive | help
Folks,
I am going to change default command line for tidy(1) used in
doc/ tree (and www/ tree then).
It should look like:
-TIDYOPTS?= -i -m -f /dev/null ${TIDYFLAGS}
+TIDYOPTS?= -i -m -f /dev/null -raw -preserve ${TIDYFLAGS}
Positive effects on this change:
* We will stop getting problems with non-Latin1 translations of
FreeBSD documentation which we always had since starting to use
tidy(1). They're mostly resolved in current state of doc/ tree, but
some still around.
* We will remove all occurences of "TIDYFLAGS+={-raw,-latin1}" from
Russian and Japanese Makefile.inc's since they're not needed anymore.
* We will not worry about problems with strangely decoded characters
entities in non-Latin1 documents anymore.
Side effects on this change:
* In newly generated Latin1 html files we'll have following differences:
. < and > (instead of < and >)
. plain & in URLs (instead of &)
. ™ (instead of ™)
as diff(1) between generated trees w/ and w/o '-raw -preserve' options shown.
Atcually I've even previewed new pages with all available to me browsers
and found no difference.
* It will require everybody who want to continue to work on doc/www trees
to update their tidy port (old distfile, but with new FreeBSD patches)
Objections ?
PS: In case of objections I will add usage of these options to
Japanese and Russian sub-trees only.
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?20011127201930.A20801>