From owner-freebsd-doc@FreeBSD.ORG  Tue Jan 21 14:00:41 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 4BB3D8F5
 for <doc@FreeBSD.org>; Tue, 21 Jan 2014 14:00:41 +0000 (UTC)
Received: from server.mypc.hu (server.mypc.hu [87.229.73.95])
 (using TLSv1 with cipher ADH-CAMELLIA256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 0176C1016
 for <doc@FreeBSD.org>; Tue, 21 Jan 2014 14:00:40 +0000 (UTC)
Received: from server.mypc.hu (localhost [127.0.0.1])
 by server.mypc.hu (Postfix) with ESMTP id 569BC14D2508
 for <doc@FreeBSD.org>; Tue, 21 Jan 2014 15:00:38 +0100 (CET)
X-Virus-Scanned: amavisd-new at !change-mydomain-variable!.example.com
Received: from server.mypc.hu ([127.0.0.1])
 by server.mypc.hu (server.mypc.hu [127.0.0.1]) (amavisd-new, port 10024)
 with LMTP id AUGUjPC4Ywd2 for <doc@FreeBSD.org>;
 Tue, 21 Jan 2014 15:00:37 +0100 (CET)
Received: from [192.168.0.10] (54034B4D.catv.pool.telekom.hu [84.3.75.77])
 (using TLSv1 with cipher DHE-RSA-CAMELLIA256-SHA (256/256 bits))
 (No client certificate requested)
 by server.mypc.hu (Postfix) with ESMTPSA id 058C514D242C
 for <doc@FreeBSD.org>; Tue, 21 Jan 2014 15:00:37 +0100 (CET)
Message-ID: <52DE7D76.5040609@kovesdan.org>
Date: Tue, 21 Jan 2014 15:00:22 +0100
From: =?ISO-8859-1?Q?G=E1bor_K=F6vesd=E1n?= <gabor@kovesdan.org>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:17.0) Gecko/20130801 Thunderbird/17.0.8
MIME-Version: 1.0
To: doc@FreeBSD.org
Subject: RFC: line numbered programlisting in HTML docs
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 21 Jan 2014 14:00:41 -0000

Hi,

in the pdf version of the documentation we have rendered line wrap 
indicators that show the reader when a long line has been wrapped into 
multiple lines so that it can be rendered. In the HTML version we have 
scrollable programlistings, which is not so smart since you may need to 
scroll to read all of the code, which is not comfortable. Using line 
wrap indicators in HTML is only possible with an ugly CSS trick but if 
we number the lines, which in turn is quite easy, it becomes obvious 
when a long line is wrapped. This is what I propose for programlisting 
and screen elements. Also, line numbering is a useful feature in itself.

Demo: http://kovesdan.org/doc/proglist.html

Patch: http://kovesdan.org/patches/programlisting.diff

Any objection to this change?

Thanks,
Gabor