2015年7月16日木曜日

debmake and debamke-doc and debian-handbook

While updating the maintainer's guide, I had faced with several issues to update it as it is, since it was based on the dh-make package and does not play nice with new features such as multi-arch etc.  Also. the lack of capability to create a decent copyright information template was my concern.

I have created the debmake tool to address shortcomings of dh-make.  It was good attempt for Jessie, but it has not so nice bug on parsing copyright.  So I decided to drop it for Jessie.
  https://packages.qa.debian.org/d/debmake.html

The current testing repository has the updated debmake command.  With the -k option, you can check if the your debian/copyright is covering all the files properly in source or not.

Since I got this updated package, I rewrote the maintainer's guide from scratch.  Now it is available in the debmake-doc package.  You can see all the packaging cases including autotools, cmake, and libraries.  If I made a mistake, let me know.  As you may noticed, debian-doc related web pages are now generated from the latest uploaded packages mostly.  debmake-doc is no exception.  
  "Guide for Debian Maintainers"
   https://www.debian.org/doc/manuals/debmake-doc/index.en.html

By using debmake as the template generation tool, the document can be made shorter and there are many practical examples.  More over, all the source code examples can be found in the source tree.  Try:

 $ apt-get source debmake-doc
 $ sudo apt-get install devscripts build-essentials
 $ sudo apt-get build-dep debmake-doc
 $ cd debmake-doc*
 $ make

You get the simulated log of building all the details of the packaging examples in this way.

With upcoming uploads, I should fix some CSS for the better cell phone compatibility but this is in good shape from the PC browsers.

Oh, not last ... NOW debian-handbook is on our www.debian.org server and its mirrors.

I think this is the most comprehensive work on Debian system and deserves to be presented in our web pages prominently.  Kudos for people who wrote this fine manual.

   https://www.debian.org/doc/manuals/debian-handbook/

(I think outdated reference to old TLDP pages should be mostly dropped in our https://www.debian.org/doc/ page.)

Please note web pages on www.debian.org has been modified to make the language based content negotiation.  So you should see the page based on your browser settings.

Osamu

0 件のコメント:

コメントを投稿