Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (31)

View Page History
Okay, so we need to make a changelog file for debian. 

Here is some sample content for at changelog file, that we can use 
{code}${maven.deb.name} (0.3) unstable; urgency=low
 * Added the archive.org maven repository, so we can build without local caches.

 -- Asger Askov Blekinge <[email protected]> Mon, 30 Nov 2011 15:21:00 +0100

{code}Put this content in "resources/debian/changelog/changelog

</execution>
</executions>
</plugin>
</plugin>
{code}So, after this change, the deb package should validate. But we have forgotten something. The most important thing, actually. The executable file.

<filemode>755</filemode>
</mapper>
</data>
</data>
{code}Regenerate and validate the deb file. You should now receive the following warning:
{code}W: dk.statsbiblioteket.scape.arc-unpacker: binary-without-manpage usr/bin/arc-unpack{code}So, we need to add man pages to the project.&nbsp;

Create the file "arc-unpack.8" in resources/man/man8, and give it this content:
{code:language=none|title=sample stolen manpage}.TH arc-unpack 8 "September 10, 2003" "version 0.3" "USER COMMANDS"
{code:language=none|title=sample stolen manpage}.TH arc-unpack 8  "April 23, 2012" "version ${project.version}" "USER COMMANDS"
.SH NAME
cdspeed \- decrease the speed of you cdrom to get faster access time
arc-unpack \- ${maven.deb.description}
.SH SYNOPSIS
.B cdspeed arc-unpack
[\-h] [\-d device] \-s speed
\-f dataFile [\-o outputDir] [\-minResp number] [\-maxResp number] [\-naming [MD5,OFFSET,URL]]
.SH DESCRIPTION
Modern cdrom drives are too fast. It can take several seconds
on a 60x speed cdrom drive to spin it up and read data from
the drive. The result is that these drives are just a lot slower
than a 8x or 24x drive. This is especially true if you are only
occasionally (e.g every 5 seconds) reading a small file. This
utility limits the speed and makes the drive more responsive
when accessing small files.
.PP ${maven.deb.extendedDescription}
cdspeed makes the drive also less noisy and is very useful if
you want to listen to music on your computer.
.SH OPTIONS
.TP
\-h
display a short help text
\-f dataFile
Data file to extract. Can be an arc or warc file, and can be compressed.
.TP
\-d
use the given device instead of /dev/cdrom
\-o outputDir
extracts the resources to this dir. Defaults to the current dir.
.TP
\-s
set the speed. The argument is a integer. Zero means restore maximum
speed.
.SH EXAMPLES
\-minResp number
Ignore resources, if the http return code is lower than minResp. Useful to filter out returns below the 200 range
.TP
Set the maximum speed to 8 speed cdrom:
.B cdspeed
\-s 8
.PP
\-maxResp number
Ignore resources, if the http return code is higher than maxResp. Useful to filter out returns above the 200 range
.TP
Restore maximum speed:
.B cdspeed
\-s 0
.PP
\-naming [MD5,OFFSET,URL]
Naming scheme for the extracted resources. Each resource in the archive is identified by an URL, but URLs do not map
neatly to filenames.
The URL scheme tries to map the resource urls to files, but can fail.
The OFFSET scheme uses offsets into the arc file as filenames
The MD5 scheme md5hash the resource URLs to ensure valid unique filenames
.SH EXIT STATUS
cdspeed returns a zero exist status if it succeeds to change to set the
maximum speed of the cdrom drive. Non zero is returned in case of failure.
arc-unpack returns zero if the extraction succeeded
.SH AUTHOR
Guido Socher (guido (at) linuxfocus.org)
.SH SEE ALSO
eject(1){code} ${maven.deb.maintainer}
{code}
It is important that the file starts with ".TH arc-unpack 8" but the rest seems optional