libosmo-sccp[master]: Add doxygen docs

This is merely a historical archive of years 2008-2021, before the migration to mailman3.

A maintained and still updated list archive can be found at https://lists.osmocom.org/hyperkitty/list/gerrit-log@lists.osmocom.org/.

Neels Hofmeyr gerrit-no-reply at lists.osmocom.org
Tue Oct 17 10:20:44 UTC 2017


Patch Set 2: -Code-Review

> No, only for repositories where:
 > - we need to add doxygen docs
 > - doc/examples are used
 > - such move would not cause any complications (.deb packaging does
 > not rely on it etc)

My intention is to generally have matching structures in all of our git repositories; currently that is mostly doc/examples, right?

I was thinking about it, and a reason to keep the doc/ dir would be that we also have other documentation in the doc/ dirs in some git repositories. But our tendency is to move all of those additional docs to osmo-gsm-manuals, so it should mostly be ok to have just an examples dir with config examples in it.

A reason against is that some wiki pages etc may point to examples by git.osmocom.org/ URLs which would then break.

And for some repositories we do install examples from debian, so we need to take care that these are still installed in prefix/share/doc.

so ... I am kind of fine with it I guess, but I'd like this to be similar in all git repositories and prefer if example URLs don't break ... hmm. Would be easy to +2 without the file move. The move makes it hard for me to agree, in the line of Holger's comments to avoid cosmetic changes in general.

-- 
To view, visit https://gerrit.osmocom.org/4234
To unsubscribe, visit https://gerrit.osmocom.org/settings

Gerrit-MessageType: comment
Gerrit-Change-Id: I2bf7438bcdde19dc88b9bc14c8ad9c8f49099f8a
Gerrit-PatchSet: 2
Gerrit-Project: libosmo-sccp
Gerrit-Branch: master
Gerrit-Owner: Max <msuraev at sysmocom.de>
Gerrit-Reviewer: Harald Welte <laforge at gnumonks.org>
Gerrit-Reviewer: Jenkins Builder
Gerrit-Reviewer: Max <msuraev at sysmocom.de>
Gerrit-Reviewer: Neels Hofmeyr <nhofmeyr at sysmocom.de>
Gerrit-HasComments: No



More information about the gerrit-log mailing list