https://projects.osmocom.org/https://projects.osmocom.org/favicon.ico?16647414092019-04-05T11:20:47ZOpen Source Mobile CommunicationsCellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=138212019-04-05T11:20:47Zosmith
<ul><li><strong>Status</strong> changed from <i>New</i> to <i>In Progress</i></li></ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=138822019-04-11T09:30:46Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-gsm-manuals: merge all patches</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-ci: merge "OBS: build osmo-gsm-manuals-dev in nightly"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>OBS: verify that osmo-gsm-manuals-dev builds in nightly</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-bts: merge "debian: create -doc subpackage with pdf manuals"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>OBS: verify that osmo-bts-doc builds in nightly</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-gsm-manuals: tag version</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-ci: create "OBS: build osmo-gsm-manuals-dev in latest"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>osmo-ci: merge "OBS: build osmo-gsm-manuals-dev in latest"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>OBS: verify that osmo-gsm-manuals-dev builds in latest</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>all osmo repos: create "debian: create -doc subpackage with pdf manuals"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>all osmo repos: merge "debian: create -doc subpackage with pdf manuals"</i> added</li><li><strong>% Done</strong> changed from <i>0</i> to <i>50</i></li></ul>Patches created for:
<ul>
<li>create osmo-gsm-manuals-dev debian package</li>
<li>create osmo-bts-doc package (as example, other repos will follow)</li>
<li>adjust osmo-ci to build osmo-gsm-manuals-dev</li>
</ul>
Local testing done:
<ul>
<li>osmo-gsm-manuals-dev builds (<code>dpkg-buildpackage -tc -uc -us</code> and with <code>pbuilder</code> to make sure that dependencies are right)</li>
<li>osmo-bts builds with the new osmo-gsm-manuals-dev package and installs the manuals to <code>/usr/share/doc/osmocom/</code></li>
</ul>
<p><a class="user active" href="https://projects.osmocom.org/users/30187">pespin</a>, since you have been doing the packaging for the most part, can you review the patches?</p>
<p><a class="external" href="https://gerrit.osmocom.org/#/q/topic:debian-doc-subpkg">https://gerrit.osmocom.org/#/q/topic:debian-doc-subpkg</a></p>
<p>(The patches depending on others are set to WIP. As usually, on what they depend is listed in the commit message.)</p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=139202019-04-15T06:50:51Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-gsm-manuals: merge all patches</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-ci: merge "OBS: build osmo-gsm-manuals-dev in nightly"</i> set to Done</li></ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=139402019-04-15T07:44:28Zosmith
<ul></ul><p>The OBS nightly job fails to build osmo-gsm-manuals-dev right now. It seems that a proper version is required, even for the nightly job: <a class="external" href="https://jenkins.osmocom.org/jenkins/job/Osmocom_OBS_nightly/54/console">https://jenkins.osmocom.org/jenkins/job/Osmocom_OBS_nightly/54/console</a></p>
<p>Therefore I have prepared a 0.1.0 release here:<br /><a class="external" href="https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/13635/">https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/13635/</a></p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=139712019-04-15T08:52:29Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-gsm-manuals: tag version</i> set to Done</li></ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=139722019-04-15T09:37:11Zosmith
<ul><li><strong>% Done</strong> changed from <i>50</i> to <i>60</i></li></ul><p>Release is tagged, the nightly jenkins job runs again. It uploads the source packages successfully.<br />However, OBS only builds the Ubuntu 18.04 and 18.10 packages so far. Packages for other distros have dependency issues:</p>
<p><a class="external" href="https://build.opensuse.org/package/show/network:osmocom:nightly/osmo-gsm-manuals">https://build.opensuse.org/package/show/network:osmocom:nightly/osmo-gsm-manuals</a></p>
<p>I'm looking into it.</p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=140272019-04-17T10:37:07Zosmith
<ul></ul><p>There were two dependency issues:</p>
<ul>
<li>"have choice for jadetex needed by docbook-utils: jadetex texlive-formats-extra"
<ul>
<li>Resolved by <a href="https://osmocom.org/projects/cellular-infrastructure/wiki/OBS_Maintenance#Package-is-not-resolvable" class="external">adjusting the project config</a></li>
</ul></li>
</ul>
<ul>
<li>asciidoc-dblatex does not exist in debian 8, but is necessary in debian 9
<ul>
<li>Will be resolved by these two patches:
<ul>
<li><a class="external" href="https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/13657/">https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/13657/</a></li>
<li><a class="external" href="https://gerrit.osmocom.org/#/c/osmo-ci/+/13658/">https://gerrit.osmocom.org/#/c/osmo-ci/+/13658/</a></li>
</ul></li>
</ul></li>
</ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=142462019-05-08T11:52:45Zlaforge
<ul></ul><p>just pushed those patches without waiting for +3 due to long delay without review :/</p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=145312019-05-20T10:25:27Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>OBS: verify that osmo-gsm-manuals-dev builds in nightly</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-bts: merge "debian: create -doc subpackage with pdf manuals"</i> set to Done</li></ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=145362019-05-20T12:30:09Zosmith
<ul></ul><p>For some reason, the osmo-gsm-manuals-dev deb is empty when built in OBS (although it has all data locally). Therefore osmo-bts failed to build with the osmo-gsm-manuals package from OBS. I've reverted the patch that makes use of osmo-gsm-manuals-dev in osmo-bts for now. Next up for me is looking into <strong>why</strong> that package is empty on OBS, creating a fix, and testing everything in my own OBS namespace before merging to master.</p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=145752019-05-23T09:15:15Zosmith
<ul><li><b>Checklist item</b> deleted (<strike><i>OBS: verify that osmo-bts-doc builds in nightly</i></strike>)</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>OBS (osmith42): get all packages for all distros and all arches building with the "osmith/pdfs-in-doc-subpackage" branch</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>Tag a release of osmo-gsm-manuals</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>all osmo repos: submit "debian: create -doc subpackage with pdf manuals"</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' disabled> <i>OBS: verify that all packages are building after the merge</i> added</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>all osmo repos: create "debian: create -doc subpackage with pdf manuals"</i> set to Done</li><li><strong>% Done</strong> changed from <i>60</i> to <i>70</i></li></ul><p>Time to write an update.</p>
<ul>
<li>Empty package issue was fixed here (merged): <a class="external" href="https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/14114/">https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/14114/</a></li>
<li>osmo-gsm-manuals needs more explicit dependencies to build on debian 8, fixed here (merged): <a class="external" href="https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/14115/">https://gerrit.osmocom.org/#/c/osmo-gsm-manuals/+/14115/</a></li>
<li>Repositories in my home:osmith42 namespace updated to current osmocom:nightly (since new repositories have been added there)</li>
<li>I went through all Osmocom repositories and added the manuals subpackage patch</li>
<li>Now I'm waiting for OBS to build the packages: <a class="external" href="https://build.opensuse.org/project/show/home:osmith42">https://build.opensuse.org/project/show/home:osmith42</a></li>
</ul> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=146412019-05-29T10:18:53Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-ci: create "OBS: build osmo-gsm-manuals-dev in latest"</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>OBS: verify that osmo-gsm-manuals-dev builds in latest</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>OBS (osmith42): get all packages for all distros and all arches building with the "osmith/pdfs-in-doc-subpackage" branch</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>Tag a release of osmo-gsm-manuals</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>all osmo repos: submit "debian: create -doc subpackage with pdf manuals"</i> set to Done</li><li><strong>% Done</strong> changed from <i>70</i> to <i>90</i></li></ul>Everything tested in my own OBS namespace:
<ul>
<li><a class="external" href="https://build.opensuse.org/project/show/home:osmith42">https://build.opensuse.org/project/show/home:osmith42</a> (all packages built with osmocom-nightly-packages.sh)</li>
<li><a class="external" href="https://download.opensuse.org/repositories/home:/osmith42/Debian_9.0/all/">https://download.opensuse.org/repositories/home:/osmith42/Debian_9.0/all/</a> (resulting nightly -doc packages can be downloaded here)</li>
<li><a class="external" href="https://build.opensuse.org/project/show/home:osmith42:latest">https://build.opensuse.org/project/show/home:osmith42:latest</a> (osmo-gsm-manuals built with osmocom-latest.packages.sh)</li>
</ul>
<p>Remaining patches submitted:<br /><a class="external" href="https://gerrit.osmocom.org/#/q/topic:debian-doc-subpkg+status:open">https://gerrit.osmocom.org/#/q/topic:debian-doc-subpkg+status:open</a></p>
<p>Almost done, waiting for patch review :)</p> Cellular Network Infrastructure - Bug #3899: user manuals are not part of debian "-doc" packageshttps://projects.osmocom.org/issues/3899?journal_id=146912019-06-03T06:52:36Zosmith
<ul><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>osmo-ci: merge "OBS: build osmo-gsm-manuals-dev in latest"</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>all osmo repos: merge "debian: create -doc subpackage with pdf manuals"</i> set to Done</li><li><b>Checklist item</b> <input type='checkbox' class='checklist-checkbox' checked disabled> <i>OBS: verify that all packages are building after the merge</i> set to Done</li><li><strong>Status</strong> changed from <i>In Progress</i> to <i>Resolved</i></li><li><strong>% Done</strong> changed from <i>90</i> to <i>100</i></li></ul>