Thursday, November 01, 2007

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
E: packagename;something

This mean that you have an Error.
W: packagename;something
This mean that you have wanning.

while package name is your the name of your package


I had the next Errors:

  1. E: smser; No manual page for binary
This mean that you have some error with the man file (here is a guide how to create it from scracth)

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:

rlafuente said...

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!

Jabka Atu said...

NP ,
Have fun in packaging ...