Hello Osmocom community,
Over the past several months I developed my own RTP endpoint
implementation library (alternative to libortp), and I seek to get it
merged into libosmo-netif so it can be used by OsmoBTS as an option:
https://gerrit.osmocom.org/c/libosmo-netif/+/39280
https://gerrit.osmocom.org/c/libosmo-netif/+/39281
https://gerrit.osmocom.org/c/libosmo-netif/+/39291
I am now working on documentation, which I need to finish before I can
lift these patches out of WIP in Gerrit. The last of the 3 WIP patches
linked above is the one adding an adoc manual, built with the same
tools as other Osmocom manuals, and I need some help with this one:
1) When I run './configure --enable-manuals' followed by 'make' on the
Debian machine which Vadim provided to me for Osmocom documentation
work, everything seems successful and I get a PDF rendering of my WIP
manual. However, as soon as I uploaded this patch to Gerrit, I see a
build failure in Jenkins. What am I doing wrong? I'm afraid that my
knowledge of Autotools is not good enough to figure this one out.
2) My progress in writing the actual manual has reached the point
where I need to insert some graphical diagrams showing the flow of RTP
packets and the latency and jitter they experience in transit. I am
thinking of one horizontal axis showing regularly spaced packets as
they are emitted by the source, then forward-and-down arrows showing
their transit with fixed or variable latency, then another horizontal
axis below showing the receiver's view of time, with marked arrival
times of packets (endpoints of latency arrows) and fixed-spacing times
when the GSM or TDM system polls the jitter buffer.
Question: what is the appropriate tool within the accepted Osmocom
adoc suite for drawing such diagrams? If I weren't trying to get my
RTP implementation accepted into Osmocom, I would have written this
manual in troff on my favorite 1980s UNIX system, using pic preprocessor
in the troff suite for graphical drawings like this one - but I reason
that I need to write my manual within Osmocom documentation framework
in order to maximize the chance of the associated code library being
accepted into libosmo-netif, with follow-on patches to osmo-bts to use
it optionally as an alternative to libortp.
3) When I do successful test builds on Vadim's Debian machine and get
a PDF rendering of my WIP manual, the cover page in the PDF features
both Sysmocom and Osmocom logos just like the mainstream Osmocom
manuals, with Sysmocom logo on top. While this arrangement is probably
appropriate for the existing manuals which were written predominantly
by members of Sysmocom crew, it seems quite wrong for an external
contributor's manual that does not contain a single sentence written
by Sysmocom. How do I tweak things to remove that Sysmocom logo from
the cover page, or even better, put San Diego 2G Association logo in
its place? My contributions to Osmocom are directly linked to my
efforts to build a new GSM network in San Diego, hence there is some
symmetry between Sysmocom and SD2G in terms of Osmocom FLOSS project
contributions, except for the rather big asymmetry in that SD2G is
strictly non-profit.
M~