From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.help Subject: RE: usability problem of emacs describe-mode Date: Sat, 28 Feb 2009 07:47:56 -0800 Message-ID: <000301c999bb$eced5280$0200a8c0@us.oracle.com> References: <76fcf833-ad89-44f2-b227-e18295317ca2@p13g2000yqc.googlegroups.com> <3c82f009-0676-4e26-bd58-d6b8c1921935@n33g2000pri.googlegroups.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1235836107 4692 80.91.229.12 (28 Feb 2009 15:48:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 Feb 2009 15:48:27 +0000 (UTC) To: "'Xah Lee'" , Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Sat Feb 28 16:49:43 2009 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LdRRd-0005r6-8X for geh-help-gnu-emacs@m.gmane.org; Sat, 28 Feb 2009 16:49:41 +0100 Original-Received: from localhost ([127.0.0.1]:45587 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LdRQI-0006iW-CW for geh-help-gnu-emacs@m.gmane.org; Sat, 28 Feb 2009 10:48:18 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LdRPw-0006hq-Po for help-gnu-emacs@gnu.org; Sat, 28 Feb 2009 10:47:56 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LdRPu-0006fx-N2 for help-gnu-emacs@gnu.org; Sat, 28 Feb 2009 10:47:56 -0500 Original-Received: from [199.232.76.173] (port=57262 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LdRPu-0006fu-HE for help-gnu-emacs@gnu.org; Sat, 28 Feb 2009 10:47:54 -0500 Original-Received: from acsinet12.oracle.com ([141.146.126.234]:49049) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LdRPt-0004Wx-US for help-gnu-emacs@gnu.org; Sat, 28 Feb 2009 10:47:54 -0500 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by acsinet12.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n1SFlaB6021334 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sat, 28 Feb 2009 15:47:38 GMT Original-Received: from acsmt706.oracle.com (acsmt706.oracle.com [141.146.40.84]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id n1SFlmRo003503; Sat, 28 Feb 2009 15:47:50 GMT Original-Received: from dradamslap1 (/141.144.72.79) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 28 Feb 2009 07:47:45 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcmZi5xidjttYIyZSYGETv6w8IksqgALqdRA In-Reply-To: <3c82f009-0676-4e26-bd58-d6b8c1921935@n33g2000pri.googlegroups.com> X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt706.oracle.com [141.146.40.84] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A010205.49A95CA3.018D:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:62477 Archived-At: > > > > * Get rid of convention of using ^L (ascii 12) for > > > > page break marker. > > > > > Is there a way to draw a sort of horizontal line for the ASCII 12 > > > symbol instead of printing "^L"? I'm talking about X version. > > > > Yes. > > Code:http://www.emacswiki.org/emacs/pp-c-l.el > > Description:http://www.emacswiki.org/emacs/PrettyControlL > > You can customize the appearance. > > The screenshot shows the default appearance. > > Thanks Drew. > I have now tried your code and it's great. I also updated it here: > > . Usability Problems Of Emacs's Mode Documentation > http://xahlee.org/emacs/modernization_mode_doc.html > > Btw, when i insert a ^L, it automatically become displayed as > horizontal line but with the overlay display "Section (Printable > Page)". Is there a way to turn that off? i.e. i just want a line. Yes, and it's described in the file and the doc strings of the user options. To quote: ------8<------------------- * Option `pp^L-^L-string': Highlighted string displayed in place of each Control-l (^L) character. If `pp^L-^L-string-function' is non-nil, then the string that function returns is used instead of `pp^L-^L-string'. * Option `pp^L-^L-string-function': Function to produce string displayed in place of each Control-l (^L) char. If this is non-nil, then option `pp^L-^L-string' is not used. You can use this option to have a dynamically defined display string. For example, with `foo' as the value, and this definition, a window-width horizontal line is displayed. (defun foo () (make-string (window-width) ?_)) In the library's Commentary: Note: If you use option `pp^L-^L-string-function' to define the ^L appearance based on the current window (e.g. its width), then you might want to add command `refresh-pretty-control-l' to variable `window-configuration-change-hook', to automatically update the ^L display whenever you resize the window: (add-hook 'window-configuration-change-hook 'refresh-pretty-control-l) ------8<------------------- So: * If you want a different static string from the default, " Section (Printable Page) ", then just customize `pp^L-^L-string'. * If you want a dynamic string, such as a horizontal line for the full window width, even as the window is resized, then use `pp^L-^L-string-function'. That option can have a function value. If it does, then whatever string that function returns is used. You can also customize the face used, and prefix and suffix strings to bookend the basic string.