doc: prepare for asciidoc based specification

This commit is contained in:
Oliver Smith 2020-04-03 09:00:00 +02:00
parent 4a3d8d3f14
commit 2baa0d5305
5 changed files with 85 additions and 0 deletions

4
.gitignore vendored
View File

@ -3,3 +3,7 @@ sim-applet/build
sim-applet/test
.sim-keys*
sim-keys*
docs/*.pdf
docs/build
docs/common
docs/*.png

8
docs/Makefile Normal file
View File

@ -0,0 +1,8 @@
OSMO_GSM_MANUALS_DIR := $(shell ./osmo-gsm-manuals-dir.sh)
srcdir=$(CURDIR)
ASCIIDOC = imsi-pseudo-spec.adoc
ASCIIDOC_DEPS =
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.asciidoc.inc
include $(OSMO_GSM_MANUALS_DIR)/build/Makefile.common.inc

View File

@ -0,0 +1,46 @@
<revhistory>
<revision>
<revnumber>1</revnumber>
<date>2020-04-03</date>
<authorinitials>OS</authorinitials>
<revremark>
Initial version.
</revremark>
</revision>
</revhistory>
<authorgroup>
<author>
<firstname>Oliver</firstname>
<surname>Smith</surname>
<email>osmith@sysmocom.de</email>
<authorinitials>OS</authorinitials>
<affiliation>
<shortaffil>sysmocom</shortaffil>
<orgname>sysmocom - s.f.m.c. GmbH</orgname>
<jobtitle>Employee</jobtitle>
</affiliation>
</author>
</authorgroup>
<copyright>
<year>2020</year>
<holder>sysmocom - s.f.m.c. GmbH</holder>
</copyright>
<legalnotice>
<para>
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.3 or any later version published by the Free Software
Foundation; with no Invariant Sections, no Front-Cover Texts,
and no Back-Cover Texts. A copy of the license is included in
the section entitled "GNU Free Documentation License".
</para>
<para>
The Asciidoc source code of this manual is linked at
<ulink url="https://osmocom.org/projects/imsi-pseudo/wiki">
https://osmocom.org/projects/imsi-pseudo/wiki
</ulink>
</para>
</legalnotice>

View File

@ -0,0 +1 @@
= IMSI Pseudonymization

26
docs/osmo-gsm-manuals-dir.sh Executable file
View File

@ -0,0 +1,26 @@
#!/bin/sh -e
# Find OSMO_GSM_MANUALS_DIR and print it to stdout. Print where it was taken from to stderr.
# Find it in env, pkg-conf and ../../osmo-gsm-manuals
RET="$OSMO_GSM_MANUALS_DIR"
if [ -n "$RET" ]; then
RET="$(realpath $RET)"
echo "OSMO_GSM_MANUALS_DIR: $RET (from env)" >&2
else
RET="$(pkg-config osmo-gsm-manuals --variable=osmogsmmanualsdir 2>/dev/null || true)"
if [ -n "$RET" ]; then
echo "OSMO_GSM_MANUALS_DIR: $RET (from pkg-conf)" >&2
else
RET="$(realpath $(realpath $(dirname $0))/../../osmo-gsm-manuals)"
echo "OSMO_GSM_MANUALS_DIR: $RET (fallback)" >&2
fi
fi
# Print the result or error message
if [ -d "$RET" ]; then
echo "$RET"
else
echo "ERROR: OSMO_GSM_MANUALS_DIR does not exist!" >&2
echo "Install osmo-gsm-manuals or set OSMO_GSM_MANUALS_DIR." >&2
exit 1
fi