emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Extend Outline mode with default visibility state


From: Eli Zaretskii
Subject: Re: Extend Outline mode with default visibility state
Date: Sun, 16 Jan 2022 21:21:01 +0200

> Date: Sun, 16 Jan 2022 20:42:07 +0200
> From: Eli Zaretskii <eliz@gnu.org>
> Cc: emacs-devel@gnu.org
> 
> The doc string of outline-default-rules also "Needs Work":
> 
>   (defcustom outline-default-rules nil
>     "Determines visibility of subtree starting at `outline-default-state' 
> level.
> 
> If this is only relevant to a single value of outline-default-state,
> the doc string should say so.
> 
>   - A lambda function or function name which will be evaluated with
>     point at the beginning of the heading and the match data set
>     appropriately, the function being expected to toggle the
>     heading visibility."
> 
> This should tell what arguments, if any, the function is called.
> Also, "function ... will be evaluated" is not our style.

In addition, the "A lambda function or function name" part seems to be
incorrect: it should be a cons cell of the form

  (custom-function FUNCTION)

Right?



reply via email to

[Prev in Thread] Current Thread [Next in Thread]