Man file in debian packaging errors
Hello,..
since i didn't found a quick answer using google (i got an answer at OFTC/debian-mentors)
I had a few frustrating weeks with debinazation of smser i had few problems
I had three major problems (at first i had only one):
after the package creation using:
dbuild -rfakeroot
you will may get errors or warning from lintian (that automatically run after the previous command )
the line starting with
while package name is your the name of your package
creating ./packagename.1 manual page (using debian/manpage.1) for the example i will call it smser.1 the file should be in the parent directory (the one named packagename-version)
inside the manfile (that was previusly created by editing ./debian/manfile.1.ex or crating from scratch)
change the "SECTION" to a number 1-8 that is corresponding with the suffix of the file :
if the filename is named smser.1 then the number instead of "SECTION" should be 1
the original line is :
should be changed to:
2.W: manpage-has-bad-whatis-entry usr/share/man/man1/smser.1.gz
The whaitis section is the section around the name :
SH NAME
smser \- program to do something
.SH SYNOPSIS
be awere not to loose the '\-'
3.W: manpage-section-mismatch usr/share/man/man1/smser.1.gz:5 1 != NET
The section in the manfile is not as preffix .
since i didn't found a quick answer using google (i got an answer at OFTC/debian-mentors)
I had a few frustrating weeks with debinazation of smser i had few problems
I had three major problems (at first i had only one):
after the package creation using:
dbuild -rfakeroot
you will may get errors or warning from lintian (that automatically run after the previous command )
the line starting with
E: packagename;somethingThis mean that you have an Error.
W: packagename;somethingThis mean that you have wanning.
while package name is your the name of your package
I had the next Errors:
- E: smser; No manual page for binary
creating debian/manfiles:
cd ./debian/
echo "manfilename" > manfiles
manfilename : it the previusly created man file (you can use the file manfile.1.ex inside ./debian )
creating ./packagename.1 manual page (using debian/manpage.1) for the example i will call it smser.1 the file should be in the parent directory (the one named packagename-version)
inside the manfile (that was previusly created by editing ./debian/manfile.1.ex or crating from scratch)
change the "SECTION" to a number 1-8 that is corresponding with the suffix of the file :
if the filename is named smser.1 then the number instead of "SECTION" should be 1
the original line is :
.TH SMSER SECTION "November 1, 2007"
should be changed to:
.TH SMSER 1 "November 1, 2007"
2.W: manpage-has-bad-whatis-entry usr/share/man/man1/smser.1.gz
The whaitis section is the section around the name :
SH NAME
smser \- program to do something
.SH SYNOPSIS
be awere not to loose the '\-'
3.W: manpage-section-mismatch usr/share/man/man1/smser.1.gz:5 1 != NET
The section in the manfile is not as preffix .
2 comments:
thanks so much for this post. I got pretty much the same error messages and was much relieved to find someone got through the trouble to explain this through! Cheers!
NP ,
Have fun in packaging ...
Post a Comment