From owner-freebsd-doc@FreeBSD.ORG Sun Nov 7 22:30:41 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 76A5416A4CE for ; Sun, 7 Nov 2004 22:30:41 +0000 (GMT) Received: from nic.ach.sch.gr (nic.sch.gr [194.63.238.4]) by mx1.FreeBSD.org (Postfix) with ESMTP id 3264243D39 for ; Sun, 7 Nov 2004 22:30:40 +0000 (GMT) (envelope-from keramida@freebsd.org) Received: (qmail 9764 invoked by uid 207); 7 Nov 2004 22:30:36 -0000 Received: from keramida@freebsd.org by nic by uid 201 with qmail-scanner-1.21 (sophie: 3.04/2.19/3.81. Clear:RC:1(81.186.70.82):. Processed in 0.715864 secs); 07 Nov 2004 22:30:36 -0000 Received: from dialup82.ach.sch.gr (HELO gothmog.gr) ([81.186.70.82]) (envelope-sender ) by nic.sch.gr (qmail-ldap-1.03) with DES-CBC3-SHA encrypted SMTP for ; 7 Nov 2004 22:30:35 -0000 Received: from gothmog.gr (gothmog [127.0.0.1]) by gothmog.gr (8.13.1/8.13.1) with ESMTP id iA7MUUIJ001536 for ; Mon, 8 Nov 2004 00:30:31 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.gr (8.13.1/8.13.1/Submit) id iA7MUUCJ001535 for freebsd-doc@freebsd.org; Mon, 8 Nov 2004 00:30:30 +0200 (EET) (envelope-from keramida@freebsd.org) Date: Mon, 8 Nov 2004 00:30:29 +0200 From: Giorgos Keramidas To: freebsd-doc@freebsd.org Message-ID: <20041107223028.GA1505@gothmog.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Subject: Line length limit suggestion in the FDP primer X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 07 Nov 2004 22:30:41 -0000 The style guide of the FDP primer mentions using 70-column lines. IMHO, this is too short, as I mentioned to a personal email exchange with Tillman Hodgson a few days back. A line length of 78 columns is probably ok these days (I usually run terminals much wider, but I don't have a problem with keeping this under the 80-column limit). Any objections against the following patch (submitted by Tillman)? : Index: writing-style/chapter.sgml : =================================================================== : RCS file: /exports/doc/doc/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.sgml,v : retrieving revision 1.40 : diff -u -r1.40 chapter.sgml : --- writing-style/chapter.sgml 22 Sep 2004 18:04:52 -0000 1.40 : +++ writing-style/chapter.sgml 4 Nov 2004 21:53:09 -0000 : @@ -245,7 +245,7 @@ : : augroup sgmledit : autocmd FileType sgml set formatoptions=cq2l " Special formatting options : - autocmd FileType sgml set textwidth=70 " Wrap lines at 70 spaces : + autocmd FileType sgml set textwidth=78 " Wrap lines at 78 columns : autocmd FileType sgml set shiftwidth=2 " Automatically indent : autocmd FileType sgml set softtabstop=2 " Tab key indents 2 spaces : autocmd FileType sgml set tabstop=8 " Replace 8 spaces with a tab