From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S270387AbTGRUel (ORCPT ); Fri, 18 Jul 2003 16:34:41 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S271821AbTGRUeg (ORCPT ); Fri, 18 Jul 2003 16:34:36 -0400 Received: from pasmtp.tele.dk ([193.162.159.95]:30986 "EHLO pasmtp.tele.dk") by vger.kernel.org with ESMTP id S271820AbTGRUeD (ORCPT ); Fri, 18 Jul 2003 16:34:03 -0400 Date: Fri, 18 Jul 2003 22:48:52 +0200 From: Sam Ravnborg To: Linus Torvalds Cc: linux-kernel@vger.kernel.org, Michael Still Subject: [PATCH] docbook: Added support for generating man files Message-ID: <20030718204852.GA4443@mars.ravnborg.org> Mail-Followup-To: Linus Torvalds , linux-kernel@vger.kernel.org, Michael Still Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.4.1i Sender: linux-kernel-owner@vger.kernel.org X-Mailing-List: linux-kernel@vger.kernel.org Hi Linus - please apply. Only docbook relevant changes. Originally by Michael Still This patch adds two new targets to the docbook makefile -- mandocs, and installmandocs. The targets require two new perl scripts in the scripts/ directory, but in return we get a series of man pages for kernel functions, which are installed in man section 9. This is a good thing, as many programmers expect documentation to be available with man, and hunting through various PS or PDF documents to find the documentation for the function you want can be quite frustrating. The man pages are just extracted from the various existing DocBook SGML documents, which are generated by kernel-doc. You also need to have docbook2man installed on your machine. Please note the formatting is not perfect, but I will tweak other stuff later with further patches -- this is just an initial implementation. Sample output (HTMLised) can be found at http://www.stillhq.com/linux/mandocs/2.5.68/ and http://www.stillhq.com/linux/mandocs/2.5.70/