howto: manpage von notify-send ändern

[MoonKid]

Es gibt zwei Bugs bezüglich der manpage von libnotif. Um nicht immer nur zu "melden", möchte ich die jetzt auch mal beheben.

Zwei Probleme tauchen dabei auf:

• Im Tracker finde ich unter "browse source code" keine manpage.
• Ebenso sehe ich kein git-repository oder ähnliches. Bin den Umgang mit GitHub und GitLab gewohnt. Möchte also ein repository forken und einen PR setzen. Ich weiß, es gibt wohl source-debs, aber da ist vermutlich auch kein .git directory drin. Ein simples .patch-file erstellen, erscheint mir oldschool. Debian hat doch da bestimmt ne elegante Lösung?

[eggy]

Ein kurzes "apt-get source libnotify" in nem temporären Verzeichnis und dann liegt in der Regel alles zum Bau nötige vor Dir. Ob das Paket in nem git verwaltet wird oder nicht hängt vom jeweiligen Maintainer ab, in dem Fall hab ich keins gesehn. Hier scheint svn die Qual der Wahl zu sein.

Code: Alles auswählen

apt-get source gitolite3
[..]
HINWEIS: »gitolite3«-Paketierung wird betreut im »Git«-Versionsverwaltungssystem auf:
[...]

wohingegen apt-get source libnotify sagt 
[...]
HINWEIS: »libnotify«-Paketierung wird betreut im »Svn«-Versionsverwaltungssystem auf:
svn://anonscm.debian.org/pkg-gnome/desktop/unstable/libnotify
[...]

Also doch einfach den .patch an den Bugtracker schicken.

[MoonKid]

Danke für den Hinweis. SVN hab ich vor ewigen Zeiten genutzt. d.h. da gibt es keine Möglichkeit PRs zu machen oder ähnliches?

Bleibt die Frage: Wo ist die manpage?

[eggy]

Code: Alles auswählen

$ find . -iname "*man*" 
    ./libnotify-0.7.7/debian/libnotify-bin.manpages                                                                                                                                                 
$ cat ./libnotify-0.7.7/debian/libnotify-bin.manpages 
    debian/notify-send.1

Demnach liegt die also in ./libnotify-0.7.7/debian/notify-send.1
Falls Du mit unkompilierten manpages bisher noch nichts zu tun hattest, nicht über die "komischen Zeichen" wundern, das ist schon richtig so und dient der Formatierung.

[MoonKid]

Ach in debian! Wär ich ja nie drauf gekommen. Danke.

Mhm... Tue mir aber schwer damit ein Projekt zu supporten wo upstream selbst nicht gewillt ist eine manpage zu liefern. Prinzipell ist die Arbeit wertvoller wenn man bei upstream contributet. Tut man es bei der distro, ist ein Teil der Welt ausgeschlossen.

Nebenbei: Wer ist eigentlich Upstream? Ich sehe auf der Tracker-Seite keinen Link. http://www.galago-project.org scheint seit 2012 still zu sein. Die AUTHORS Datei enthält nur Einzelpersonen. README ist leer. Da ist es echt schwer ranzukommen, wenn man mal contributen will. Die Mauer ist zu hoch - aber das ist ja ein häufig diskutiertes Thema.

[inne]

Upstream dürfte GNOME sein: https://git.gnome.org/browse/libnotify (oder FreeDesktop.org, aber dort ist das im Git nicht dabei)?

Die Manpage ist aber laut Vermerk für Debian geschrieben worden. Siehe Sektion AUTHOR.

Code: Alles auswählen

man debian/notify-send.1
...
AUTHOR
       This manual page was written ... for the Debian project (but may be used by others).

[MoonKid]

Und wie bist du darauf gekommen, dass das "Gnome" ist? Hab ich etwas überlesen?

[inne]

Code: Alles auswählen

$ cat debian/control
...
Source: libnotify
...
Maintainer: Debian GNOME Maintainers <pkg-gnome-maintainers@lists.alioth.debian.org>

Der Datensatz Maintainer hat mich dann wieder daran erinnert woher das kommt. Dann hab ich nochmal auf git.gnome.org nachgeschaut.

[MoonKid]

Hab mal n paar BugReports (Debian & Upstream) aufgemacht. Total nervig und zeitverschwendirsch. Ich wollte nur ne manpage fixen und verbrenne meine Zeit und die von Debian maintainern weil upstream zu <selbst was einsetzen> ist, eine minimale Projektdoku hinzubekommen.

Ich werd die "Qualitätskriterien" auch mal auf ner Debian mainlingliste diskutieren.

[inne]

Ich werd die "Qualitätskriterien" auch mal auf ner Debian mainlingliste diskutieren.

Die sind doch recht hoch. Immerhin liefert Debian die Manpage zum Programm. GNOME musst du IMO den Rüffel erteilen, warum die Manpage dort nicht mit aufgenommen und zentral gepflegt wird. Aber ich denke das weißt du auch selbst.

[MoonKid]

Ja ich empfinde die Quali-Kriterien von Debian auch als hoch. Aber es geht nicht darum, dass eine manpage ausgeliefert wird, sondern wer die Zeit investiert sie zu erstellen.

Und der Name Debian ist groß und wichtig genug, so dass man hier auch mal pädagogisch tätig werden dürfte. Wäre ich Debianer und dazu auch noch package maintainer würde ich mich nicht dazu herablassen, für upstream irgendwelche doku zu schreiben. Das sollen die mal schön selbst machen. Erst recht gilt das, wenn dahinter eigentlich ein weiteres relativ große Projekt steht und nicht ein einzelner Entwickler (wie z.B. bei backintime, wo der einsame Dev fleißig und sorgfältig an seiner Doku arbeitet!) Gnome hat das Know-How und die Ressourcen, um zu wissen, wie wichtig Doku ist und um es selbst zu machen. Offensichtlich sind einfach die Prios dort andere und/oder die Orga nicht ausgefeilt genug.

[inne]

Wäre ich Debianer und dazu auch noch package maintainer würde ich mich nicht dazu herablassen, für upstream irgendwelche doku zu schreiben.

Der Maintainer hat die bestimmt für die User geschrieben, oder wegen d. Lintian Fehler. Also den Upstream supported.
Neue Doku schreiben, kann von Zeit zu Zeit auch Spaß machen

Das sollen die mal schön selbst machen.

Zumindest sollten sie die Doku entsprechend aufnehmen, wenn man diese dort einreicht.

[MoonKid]

Zumindest sollten sie die Doku entsprechend aufnehmen, wenn man diese dort einreicht.

https://bugzilla.gnome.org/show_bug.cgi?id=757151

[inne]

Verstehe ich auch nicht. Der Löwenanteil ist ja schon getan... und es ist nicht mal Quellcode in dem Sinne.