Do not require having the graphical application inkscape and all its
dependencies installed, just to convert svgs to pdfs. This is still the
default in dblatex, even though converting on the command-line with
inkscape is deprecated. Use the lightweight rsvg-convert instead.
Merge at the same time as the docker-playground patch.
Depends: docker-playground I012c61eb777e6dc267dd4a52500da98c01ac1438
Change-Id: I0d132f8f6fd73fbe14b5bfa10a8659acaddf38f7
* Move the comments above the build targets, so they don't get printed
during the build
* Remove the "TO REMOVE DRAFT MODE…" note. Printing this is no longer
useful, the manuals for releases are now generated automatically with
the Osmocom-release-manuals jenkins job, which removes the draft mode.
There is no need to do this step manually.
Depends: osmo-ci Ia27cb8e4dd0204c0a91c322bed65bf8c9847a7be
Change-Id: I23d11bab274793eb8bcedc3fd9290901823e32d2
When Makefile.docbook.inc gets included by openbsc, the PWD Makefile
variable is empty (probably because the including file is not generated
by automake). Use the shell pwd command instead.
This fixes the master-openbsc jenkins job which has been failing since
previous patch dba860c7 ("VTY references: set git version and date")
was merged.
Related: OS#4063
Change-Id: I6026623ec9a5eef0ca8c47bf46605086e361c2bc
Fix that VTY references currently don't have the version from which they
were generated. Set the same REVNUMBER and GIT_DATE variables in
Makefile.docbook.inc (gets included in Makefile.vty-rference.inc)
as in Makefile.asciidoc.inc. Use them with a new script to rewrite the
<revhistory> block of vty references.
Closes: OS#4063
Change-Id: I68a8c3893d3c3a3b1bc1aee442a17635b60ac531
Use the full path to shrink-pdfs.sh, so it works as expected when the
symlinks are not present. This is how pysim uses the publish/shrink
targets.
Fix for:
build/shrink-pdfs.sh _build/latex/osmopysim-usermanual.pdf
make: build/shrink-pdfs.sh: Command not found
Related: SYS#6380
Change-Id: Iba6e0e4932741adcb9e54e54eb7774716fb2e244
Group upload and publish closer together by moving the clean targets to
the bottom.
Related: SYS#6380
Change-Id: Id8b6ead89a2aeba28e9c55bcfde6564376e8418a
Describe what upload and publish do, it's not clear from the name of
these make targets.
Related: SYS#6380
Change-Id: Ic2ab9df2192912d20ede0241abe01e8d26a9afcc
Add a custom graphviz-filter.conf, so asciidoc instructs graphviz to
generate svgs.
Related: SYS#6380
Change-Id: Iee54012c41f554608b0915d707f7cf64bfbdc418
Generate svgs instead of pngs. Vector graphics have smaller file size
and don't look blurry when zooming into them.
Related: SYS#6380
Change-Id: I24f345a19adbc5abe41737233f89916996569ea8
Don't have a default value for OSMO_REPOSITORY, as this leads to manuals
getting uploaded to the wrong directory (publish) target and installed
to the wrong directory (install, uninstall).
Add checks to ensure the variable is set before using it in install and
uninstall.
Related: OS#5902
Change-Id: Ie21d58dd57a893a83f566eea464ab3eec82b67a4
Don't upload the manuals for master to "latest" anymore, this is
confusing given that we also refer to the most recent release as
"latest". Add the "master" directory to prepare a directory structure
where we can have manuals for each release:
osmo-hlr/
osmo-hlr/master/
osmo-hlr/master/osmohlr-usermanual.pdf
osmo-hlr/master/osmohlr-vty-reference.pdf
Related: OS#5902
Change-Id: Id090422afbd7b91ac78cc30e19372ac1c828cb6b
Add an editorconfig file so editors can figure out that the *.inc files
should be indented with tabs. At least neovim would use spaces
otherwise.
Change-Id: I93f8fa0c1f2721d12183f33f4a14e13b2deed80b
Add passage explaining basic visualisation of stat and rate counter items
with Netdata so user can start utilizing them without any special
configuration.
Related: OS#5671
Change-Id: I124503c3707bbe005abbfb4245abe2829c6ff57c
The files gb-nsw-{configuration-timer,configuration,maintenance} were
not actually chapters, but sub-chapters or sub-sub-chapters. This
breaks our general idea that all of those files are top-level chapters.
It also breaks asciidoc validation on Debian 11:
asciidoc: WARNING: gb-ns2-configuration.adoc: line 1: section title out of sequence: expected level 1, got level 2
asciidoc: WARNING: gb-ns2-maintenance.adoc: line 6: section title out of sequence: expected level 2, got level 3
the only place where they were used was the osmo-gbproxy manual, and
there in the exact sequenc in which I now merged them over here.
Change-Id: I3c618e5af61b376435f400ef9c64245cec2f9b73
... this can be included from the various user manuals to insert some
general language about the systemd service units we ship, and a few key
systemd commands to get users started.
Change-Id: I8b04047cbc4097676d69fad794bb3139c05a4a5f
Copied from osmo-bsc.git/doc/manuals/chapters/mgwpool.adoc, version from
Change-Id Id0d292506e8b2a888c8d7a682a38db80e9d0933a
Related: SYS#5987
Change-Id: Ieda0d4bfe6fc90da6e19c791d8ec2da89427ba3b
Both Synch. sequence and Training sequence are basically the same thing,
only the length is different. I guess this is why 3GPP TS 45.002 names
them differently. Let's mention them both to avoid confusion.
Change-Id: I092af5ef6b66f8bdbd46cc3ae0c77fd806f2fe27
This has been the port used historically in most existing deployments,
and it's the one already documented in the osmux section of user
manuals.
Change-Id: I9593e484a0df7cbfc3fa68f071246e3fb714bd4c