Your message dated Fri, 8 May 2009 22:03:00 +0900
with message-id <[email protected]>
and subject line Re: Bug#527457: maint-guide: Chapter 5.8, proper location for
manpages isn't specified
has caused the Debian Bug report #527457,
regarding maint-guide: Chapter 5.8, proper location for manpages isn't specified
to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)
--
527457: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=527457
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: maint-guide
Version: 1.2.14
Severity: normal
I'm not sure if this is an actual bug with the documentation itself, but
atleast I had
some issues following it. Chapter 5.8 deal with man- pages and their files,
which is
generally a nice piece of documentation. Regardless of that I tried to complie
my
package several times without getting any fresh man -pages with it.
After some debugging and google -magick I found an actual solution, I had to
1) create file debian/manpages
2) move the newly created file from myapp/debian/myapp.1 to myapp/myapp.1
I'm more or less newbie with building Debian packages, so I don't know if my
solution
is somehow broken or if there's an place for improvement with the documentation.
So, if my observations and solution are correct, I'd like to see fixed
documentation,
or if my solution is somehow faulty I'd be more than glad to hear the proper
way as
well.
--
Take
-- System Information:
Debian Release: 4.0
APT prefers oldstable
APT policy: (500, 'oldstable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.18-5-686
Locale: LANG=en_US.ISO-8859-15, LC_CTYPE=en_US.ISO-8859-15 (charmap=ISO-8859-15)
--- End Message ---
--- Begin Message ---
Hi,
On Thu, May 07, 2009 at 07:36:26PM +0300, Tapio Salonsaari wrote:
> Package: maint-guide
> Version: 1.2.14
> Severity: normal
>
> I'm not sure if this is an actual bug with the documentation itself, but
> atleast I had
> some issues following it. Chapter 5.8 deal with man- pages and their files,
> which is
> generally a nice piece of documentation. Regardless of that I tried to
> complie my
> package several times without getting any fresh man -pages with it.
>
> After some debugging and google -magick I found an actual solution, I had to
> 1) create file debian/manpages
> 2) move the newly created file from myapp/debian/myapp.1 to myapp/myapp.1
This is because your build script should have some code to move
myapp/myapp.1 to proper place.
> I'm more or less newbie with building Debian packages, so I don't know if my
> solution
> is somehow broken or if there's an place for improvement with the
> documentation.
> So, if my observations and solution are correct, I'd like to see fixed
> documentation,
> or if my solution is somehow faulty I'd be more than glad to hear the proper
> way as
> well.
debian/rule or addition to your build makefile should address manpage
movement. Considering your suggestion is not general solution and this document
is intended
to give general example, I do not think this is bug. This is something
maintainer needs to adjust build script.
Usually, any debian packaging introduced files in debian directory is
cleaner and easier to maintain. So I will keep this part as is. (This
is not bug)
Please note I am not saying your choice of myapp/myapp.1 as bug. It is
OK to do so.
Osamu
--- End Message ---
