Dokument (DocBook XSL Stylesheets) bearbeiten

[Kesandal]

Hallo zusammen,

vorab: entschuldigt, wenn es ein falsches Unterforum ist. Meiner Ansicht nach passt es hier am ehesten hinein.

Ich habe eine Erweiterung für ein Programm (rear) geschrieben.
Bevor ich nun einen Pullrequest erstelle, möchte ich die Dokumentation entsprechend erweitern.
Hier weiß ich aber so recht nicht was ich machen soll.

Im Root-Verzeichnis ist eine Datei namens rear.8.
Öffne ich diese sehen die ersten Zeilen so aus:

'\" t
.\"     Title: rear
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 10 May 2019
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "REAR" "8" "10 May 2019" "\ \&" "\ \&"
....
....
....
\fBdebugscript mode\fR
(log executed commands via
\fIset \-x\fR
\- also sets \-v and \-d)
.RE
.PP
\-\-debugscripts SET
.RS 4
same as \-d \-v \-D but
\fBdebugscript mode\fR
with
\fIset \-SET\fR
.RE
.PP
\-r KERNEL
.RS 4
kernel version to use (by default use running kernel)
.RE
.PP
\-s

Meine Frage ist nun: Wie bearbeite ich das Dokument am einfachsten?
Gibt es irgend eine Art "Editor" wo ich das "Endresultat" sehen kann?
Auf der Webseite (http://docbook.sf.net) habe ich mich umgeschaut. So richtig schlau werde ich aber nicht draus.

Vielleicht hat jemand einen Tipp für mich.

Danke im Voraus!

 

[def_]

Mit einem XML-Editor, welcher XSL Stylesheets nutzt, sollte das kein Problem sein.
Am Einfachsten geht es sicherlich mit Adobe Framemaker, da hast du dann auch eine Art Ansicht des Endresultat.

 

[RalphS]

das ist aber kein XML, das ist schon die fertige man Datei. Erkennbar am Namen: es wird ein Eintrag rear in Sektion 8 erstellt.

Schau mal weiter, da müßte auch eine Quelle für die man Datei da sein.