os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
51303 commits 1 branch 79 tags 298 MiB
Commit graph

393 commits

Author SHA1 Message Date
Wolfram Schneider
c3656ef449 Fix `make po' for updates 
PR:		227905
Differential Revision:	https://reviews.freebsd.org/D15263
 2018-05-10 20:06:54 +00:00
Marc Fonvieille
74b36f663d Update maxdepth from 6000 to 12000 [1]. This should fix the doc related 
ports build on FreeBSD 11.X.

PR:	225287
Submitted by:	Keren Sky <keren_sky@live.com>
Obtained from:	Kenji Rikitake <kenji@k2r.org> [1]
 2018-04-02 12:45:43 +00:00
Warren Block
84ce3e419a Unbreak building of translated PO files. Also intentionally hide make(1) 
output. This is not only unhelpful for translators, it is distracting
from the already difficult job of translation. If verbose output is
desired, 'make -l' can be used.
 2018-02-02 16:55:24 +00:00
Benedict Reuschling
56ff8fa0a5 Bump copyright years for the doc tree to 2018 as listed in 
https://wiki.freebsd.org/HappyNewYearCopyrightYearBumps.
I had to introduce a line-break into doc.xml.mk to avoid overlong lines.

Happy New Year everyone!
 2017-12-31 18:37:34 +00:00
Glen Barber
870aad0cf4 Fix minor grammatical nits in error output. 
Sponsored by:	The FreeBSD Foundation
 2017-12-12 16:04:47 +00:00
Wolfram Schneider
555d5d143e Do not set NO_OBJ=YES in a Makefile because /usr/share/mk/bsd.obj.mk does a test 
if NO_OBJ is defined, but not about the value.

Which means you cannot unset NO_OBJ on the command line or with env variable:

$ make NO_OBJ=""

or

$ export NO_OBJ=""; make

I still think that 'make obj' doesn't really work for the doc
project. But for now, you have to disable it yourself on the command
line or in your ~/.profile.

This is a revert of r51065
 2017-12-10 12:47:00 +00:00
Wolfram Schneider
d9d9a2b7fa support parallel "po" 
$ make p-po
 2017-10-15 09:09:54 +00:00
Wolfram Schneider
33216a38d0 make spaces 2017-10-12 15:39:02 +00:00
Wolfram Schneider
c5dbc10ef2 echo -> @${ECHO} 2017-10-12 15:20:47 +00:00
Wolfram Schneider
36b10d75a9 improve warning message 2017-10-12 15:19:45 +00:00
Wolfram Schneider
2ccc12750d standard verbose make output. 
If you do not like this, use `make -s po'

PR: 222939
 2017-10-12 15:05:42 +00:00
Wolfram Schneider
8737e8fded refactor to use make syntax instead shell/test scripts 
PR: 222939
 2017-10-12 14:57:50 +00:00
Wolfram Schneider
68c9592c28 refactor to use make syntax instead shell/test scripts 
PR: 222939
 2017-10-12 14:57:29 +00:00
Wolfram Schneider
3573c48c46 no fatal errors for english documents 
refactor to use make syntax instead shell/test scripts

PR: 222939
 2017-10-12 14:38:11 +00:00
Wolfram Schneider
a6c77942cd support `make po' for sub-directories 
PR: 222944
 2017-10-12 14:14:41 +00:00
Wolfram Schneider
5a621046a7 better check for "all" target 2017-10-12 14:14:15 +00:00
Wolfram Schneider
2539094cdb refactor translation to a new make file "doc.translate.mk" 
PR: 222939
 2017-10-12 14:13:48 +00:00
Wolfram Schneider
9c93d11e18 we need to delete the target symlink first before we can create it 
This solved the issue with symlinks to directories.  The semantic
of `ln -fs' is special if you run it for directories twice, e.g.

mkdir from
ln -sf from to
find . -name from -or -name to
./to
./from

now run it again
ln -sf from to

find . -name from -or -name to
./to
./from
./from/from

ls -l from
total 1
lrwxrwxr-x  1 wosch  devel  4 Oct  6 13:54 from -> from

PR: 222737
 2017-10-07 09:03:10 +00:00
Wolfram Schneider
b1c971fa20 <doc.docbook-dep.mk> handles implicit dependencies of DocBook documentation 
This feature can be disabled with DOCBOOK_DEPS_DISABLE=YES

Missing dependencies will be reported as a warning, and should
be fixed by the document authors.

PR: 222826
 2017-10-06 14:08:45 +00:00
Wolfram Schneider
9647f5d77d 'make obj' doesn't really work for the docs, disable it by default 
PR: 222488
 2017-10-06 10:44:00 +00:00
Wolfram Schneider
446279c5cb upgrade to INDEX-11 
PR: 222677
 2017-10-03 11:17:44 +00:00
Wolfram Schneider
032bcd2bf6 switch to HTTPS 
PR: 222676
 2017-09-29 09:46:32 +00:00
Wolfram Schneider
066c47a505 switch to HTTPS 
PR: 222676
 2017-09-29 09:18:35 +00:00
Wolfram Schneider
ef69133f3b switch to HTTPS 
PR: 222676
 2017-09-29 09:11:33 +00:00
Wolfram Schneider
1ce60faecf new variable XMLDOCS_NO_SRCS 
if set there will be no implicit adding of files to SRCS, which may
break `make -n', or `make -j1', or dependencies checking

PR: 222631
 2017-09-28 16:59:08 +00:00
Wolfram Schneider
bb54e772f9 support parallel obj 
$ make p-obj

PR: 222322
 2017-09-21 10:08:01 +00:00
Wolfram Schneider
b814de5aaf get the number of max_jobs from the command line args as well, 
e..g:

$ make -j16 p-all
 2017-09-20 09:28:40 +00:00
Wolfram Schneider
1e39127174 support parallel clean 
$ make p-clean

PR: 222322
 2017-09-19 17:40:05 +00:00
Wolfram Schneider
5472c07a33 Implement workaround for a parallel doc build 
$ make p-all

It works for the sub-directories in a given directory.

On a standard quad core machine the build time goes down
from ca. 20min to 5 minutes.

PR: 222322
 2017-09-19 10:03:26 +00:00
Wolfram Schneider
0b4df7438b fix race conditions in doc image builds 
PR: 222327
 2017-09-19 09:57:15 +00:00
Wolfram Schneider
e041adf9e7 cleanup *.ps files 
PR: 222252
 2017-09-19 09:54:21 +00:00
Wolfram Schneider
b0758f9328 Fix make -n' and make -j1' 
PR: 222186
 2017-09-19 09:50:17 +00:00
Warren Block
13f5ecf9c7 Remove the temporary assembled document after generating a PO file to 
make sure it does not hide changes in the English parent from translators.

Sponsored by:	iXsystems
 2017-09-08 14:29:06 +00:00
Warren Block
502f6e6848 Trim obsolete translations from PO files. These are translations for 
text which does not exist in the original English document any more.
 2017-08-14 21:08:28 +00:00
Warren Block
53c6e4e7db Use Subversion metadata for version information rather than grepping for 
$FreeBSD$ version strings.
 2017-05-05 13:50:57 +00:00
Baptiste Daroussin
f1e3b6cc55 Bump copyright year. 
Happy New Year 2017!
 2016-12-31 12:48:51 +00:00
Warren Block
bc9859bd07 Improve latest revision detection based on mat's work. This clarifies 
the code, reduces dependencies, and removes a lot of quotes by using
--stringparam.

Differential Revision:	https://reviews.freebsd.org/D6902
 2016-07-04 14:56:42 +00:00
Hiroki Sato
e5c4255d90 Use INDEX for the latest production release branch. 2016-06-27 00:01:56 +00:00
Mathieu Arnold
341a558a78 Fix using LATESTREVISION when not using svn (or svn is broken) 
Kinda ok'ed by:	wblock
Sponsored by:	Absolight
 2016-06-14 14:02:59 +00:00
Warren Block
094ccc9b32 Replace revision and publication date in generated documentation with 
the actual date of last update.  This fixes the problems with misleading
"last update" dates that only reflect the change in a single
rarely-changed file.  Note that hrs had reservations about doing this in
the Makefile rather than with a stylesheet.  However, not all our source
files are XML.  For now, this change works, and can be replaced by a
more elegant solution later.  We should also consider checking dates on
other files that affect the content or appearance of documents, like
images.

Submitted by:	grembo
 2016-05-04 22:04:56 +00:00
Warren Block
84c6577fe8 Generate the correct paths to images in epub documents. 2016-05-04 21:35:12 +00:00
Warren Block
0ab691adb0 Stop putting PDF contents in .ps and .rtf files. 2016-05-01 17:19:54 +00:00
Warren Block
5f388dea1d Run 'make SRCS' in the English document directory. Some SRCS files are 
generated, like the list of mirrors used in the Handbook, and this will
make certain they exist when the PO extraction process needs them.
 2016-01-26 23:42:48 +00:00
Warren Block
e7f931fbcf Put a plain $FreeBSD$ in the generated PO, rather than an ID string that 
has been expanded by Subversion.  Thanks to bjk!
 2016-01-26 23:27:44 +00:00
Warren Block
45e34fab2b Improve the formatting of dblatex-produced PDF documents. 2016-01-25 21:22:06 +00:00
Warren Block
39acb24640 Remove extraneous whitespace. 2016-01-15 01:59:38 +00:00
Bjoern A. Zeeb
8c4fed951e Bump copyright year. 
Happy New Year 2016!
 2015-12-31 11:31:41 +00:00
Warren Block
9f1fd7d856 Use the English catalog files to avoid problems with pre-translated 
entities.  Tested by rene@ and RayCherng Yu <raycherng@gmail.com>.
Well, and me, obviously.

Reviewed by:	rene
 2015-10-31 17:45:11 +00:00
Warren Block
0a4ab32374 Make the normalized translation file depend on all the SRCS of the 
English original document.

Reviewed by:	rene
 2015-10-28 00:53:13 +00:00
Warren Block
832689be3b Use the en_US xmllint catalog variables so translated entities do not 
make their way into PO translations.

Reviewed by:	rene
 2015-10-16 22:30:02 +00:00