Commit graph

395 commits

Author SHA1 Message Date
Danilo G. Baio
9c95515f3b share/mk/doc.translate.mk: Improve make po
- Create .pot (Portable Object Template) files for the en_US documents
  Do not ignore en_US language and generate a `.pot` file instead of a `.po`.
  These are used as template for tools like Zanata.

- Execute `msgattrib` even on a new `[.po|.pot]` file
  This will be useful to wrap long message lines and avoid bigger diffs in
  the future.

Approved by:	wosch
Differential Revision:	https://reviews.freebsd.org/D16726
2018-08-28 23:52:43 +00:00
Glen Barber
a6e3a552e1 Fix generation of hardware.html for 12.0.
- Move definition of various branch-specific variables from
  Makefile to Makefile.inc.
- Include share/mk/doc.commands.mk to ensure ${SVN} is properly
  defined.  If ${SVN} is defined (default) and exists, hardware
  is appended to SUBDIR.  Add MKTEMP to share/mk/doc.commands.mk
  as part of this change.
- If MAN4DIR is not defined (default), use mktemp(1) to create
  a temporary directory to check out the share/man/man4 path of
  the relevant src branch (determined by evaluating the _BRANCH
  variable defined in the Makefile).  Once the dev-auto.end is
  created, the temporary MAN4DIR is removed.  The src-checkout
  and man4-rmsrc targets are limited specifically to exclude the
  make(install) case, as pseudo-repeatable errors have been
  observed under certain conditions that have yet to be determined.
- While here, remove hwlist entities from hardware.xml from
  drivers that are no longer present in 12.0-CURRENT.
- Also while here, bump copyright dates.

This is based on a differential revision that had received no
feedback seven months:
 https://reviews.freebsd.org/D13467

Approved by:	re, doceng (implicit, silence)
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D13467
2018-07-11 18:51:18 +00:00
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