From owner-freebsd-doc Sat Jul 7 5: 8: 0 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by hub.freebsd.org (Postfix) with ESMTP id ACAC337B401 for ; Sat, 7 Jul 2001 05:07:56 -0700 (PDT) (envelope-from keramida@ceid.upatras.gr) Received: from hades.hell.gr (patr530-b102.otenet.gr [195.167.121.230]) by mailsrv.otenet.gr (8.11.1/8.11.1) with ESMTP id f67C7rh24256 for ; Sat, 7 Jul 2001 15:07:53 +0300 (EEST) Received: (from charon@localhost) by hades.hell.gr (8.11.4/8.11.4) id f67C7qc11498 for doc@freebsd.org; Sat, 7 Jul 2001 15:07:52 +0300 (EEST) (envelope-from keramida@ceid.upatras.gr) Date: Sat, 7 Jul 2001 15:07:51 +0300 From: Giorgos Keramidas To: doc@freebsd.org Subject: to wrap or not to wrap - a question of style for doc/ tree PR's Message-ID: <20010707150751.A11446@hades.hell.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i X-PGP-Fingerprint: 3A 75 52 EB F1 58 56 0D - C5 B8 21 B6 1B 5E 4A C2 X-URL: http://students.ceid.upatras.gr/~keramida/index.html Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The SGML sources of the doc/ tree are wrapped at 70 - 78 columns. However, when I am send-pr'ing changes, some times adding a tag here and there makes the lines longer than the column that they were originally wrapped. The dillema is, should I wrap the resulting SGML before doing a `cvs dif -u' or not? Wrapping the resulting source again makes it look better and it does not break the style of the document, but this makes diffs more difficult to understand; the changes are not easy to understand if I do wrap the source before diff'ing. What would the rest of you people prefer to see in a PR? I'm asking because if I do wrap the source before running diff, the patches are more difficult to understand, but if I don't the PR will probably result in more than one commits. One to apply the changes and one to reapply the style that the rest of the document has, and this is extra work for the one that will try to close the PR. Any comments welcome :-) -giorgos To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message