From owner-freebsd-ports@FreeBSD.ORG Sat Sep 11 09:10:44 2010 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BB2761065672 for ; Sat, 11 Sep 2010 09:10:44 +0000 (UTC) (envelope-from coco@executive-computing.de) Received: from mail.moehre.org (mail.moehre.org [195.96.35.7]) by mx1.freebsd.org (Postfix) with ESMTP id 3BB388FC16 for ; Sat, 11 Sep 2010 09:10:44 +0000 (UTC) Received: from mail.moehre.org (unknown [195.96.35.7]) by mail.moehre.org (Postfix) with ESMTP id D5FFA8B1435 for ; Sat, 11 Sep 2010 10:52:05 +0200 (CEST) X-Spam-Flag: NO X-Spam-Score: -100.989 X-Spam-Level: X-Spam-Status: No, score=-100.989 tagged_above=-999 required=5 tests=[ALL_TRUSTED=-1, AWL=0.011, USER_IN_WHITELIST=-100] autolearn=disabled Received: from mail.moehre.org ([195.96.35.7]) by mail.moehre.org (mail.moehre.org [195.96.35.7]) (amavisd-new, port 10024) with ESMTP id KCuK-J545Rol for ; Sat, 11 Sep 2010 10:52:00 +0200 (CEST) Received: from [192.168.100.30] (p54B0B816.dip.t-dialin.net [84.176.184.22]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: coco@executive-computing.de) by mail.moehre.org (Postfix) with ESMTPSA id 774848B141C for ; Sat, 11 Sep 2010 10:52:00 +0200 (CEST) Message-ID: <4C8B4324.90505@executive-computing.de> Date: Sat, 11 Sep 2010 10:51:48 +0200 From: Marco Steinbach User-Agent: Thunderbird 2.0.0.12 (Windows/20080213) MIME-Version: 1.0 To: freebsd-ports@freebsd.org Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit Subject: man page style questions X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Sep 2010 09:10:44 -0000 I'm reposting this to -ports, as I got no replies on -doc within several days. I'm currently preparing a man page for a yet to be submited new port, and altough I was able to get answers for some of my questions from the mdoc(7) man page and other sources, there are still some areas where I am not sure about how to properly format and label things. The current source of the man page is available at http://www.moehre.org/files/sqtop/sqtop.1 The port has an optional ncurses-based interface, which, if used, allows the behaviour of the utility to be changed by pressing certain keys. - Is "INTERACTIVE MODE" the appropiate term to be used as heading for the section dealing with the specifics of a ncurses-based user interface ? - What labels are to be used for keys which usually do not produce a printable character ? E.g. is the -key to be represented as "return", "" or "RETURN" (or is it to be named "enter", anyway ?) - What about the cursor movement and other directional keys like , , ? - Are there any preferences for the macros to use for keys to be pressed, e.g. is the following acceptable: .Bl -tag -width Fl .It Ic C Do the C thing. .It Ic A Do the A thing. .El Any hints and suggestions (wording, macro usage, etc) to make the man page a better fit to the style of the FreeBSD project are greatly appreciated. MfG CoCo