From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Extend Outline mode with default visibility state Date: Sun, 16 Jan 2022 20:42:07 +0200 Message-ID: <8335lny134.fsf@gnu.org> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15754"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Matthias Meulien , Juri Linkov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jan 16 19:44:46 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1n9AWD-0003xv-Jm for ged-emacs-devel@m.gmane-mx.org; Sun, 16 Jan 2022 19:44:45 +0100 Original-Received: from localhost ([::1]:56512 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n9AWC-000838-AE for ged-emacs-devel@m.gmane-mx.org; Sun, 16 Jan 2022 13:44:44 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:43748) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n9ATu-0007Kh-Tu for emacs-devel@gnu.org; Sun, 16 Jan 2022 13:42:23 -0500 Original-Received: from [2001:470:142:3::e] (port=52062 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n9ATt-0003pn-Hh; Sun, 16 Jan 2022 13:42:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Subject:To:From:Date:mime-version:in-reply-to: references; bh=45WB8ZVriCbGc83CjXcqzHjk0/wb9Ipm6/EPJcWF890=; b=K8IegmahoAil9p iDchLo8qeJNyWV4q6eqQWHd0ImReMfr+VJliih96aqtTOCUJjDI+NbCf6haA0gD9Rf1jFNwLo97K3 nfhemrUGLc6pa+F9cVSy32+bLbS1G5TGi3chTXwPnukaoqFpV8o5jdVK+d9aQ0667jfyZvJth6gly uyxm5HPmf9MHPC59frTjhowYXOvGzFzzA3xnAb+vp8kAQZmuP599Fa+kwmy96zIx8HEszdvaw14gU eLzMI+wqx6l3NOjHpSvF5Xa0O7nska8bH3Ag/ew5W1kAYfCuZ4wlmFNQjmFvtfY+GfYwMWNobX3YK Op2/VXM3+2NlTfemi4pA==; Original-Received: from [87.69.77.57] (port=3740 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n9ATr-0005VA-BF; Sun, 16 Jan 2022 13:42:21 -0500 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:284845 Archived-At: The doc string of outline-default-state "Needs Work": (defcustom outline-default-state nil "If non-nil, some headings are initially outlined. Note that the default state is applied when the major mode is set or when the command `outline-apply-default-state' is called interactively. What major mode does this allude to? When nil, headings visibility is left unchanged. Unchanged from what state? If equal to `outline-show-all', all text of buffer is shown. If equal to `outline-show-only-headings', only headings are shown. What does "headings" mean here? Does it mean headings off all the levels, or just of the top level, or something else? If equal to a number, show only headings up to and including the corresponding level. See `outline-default-rules' to customize visibility of the subtree at the choosen level. Is `outline-default-rules' relevant only to that single value of outline-default-state? If equal to a lambda function or function name, this function is expected to toggle headings visibility, and will be called after the mode is enabled." This doesn't say whether the function is called with any arguments. 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. Can these issues be fixed, please? Thanks.