unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
@ 2021-05-22  7:56 pietru
  2021-05-22  8:10 ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: pietru @ 2021-05-22  7:56 UTC (permalink / raw)
  To: 48580

Currently Outline Mode is confusing because (1) commands begin with describing a tree,
then shifts to describe human beings (body, children); and (2) nomenclature such as branches
and leaves challenge the formal nomenclature of evolutionary trees.

There are also problems with the use of leaves and branches.  Formally, "leaves" are
end-nodes with no children; whereas "branches" are the lines connecting the nodes, their
lengths commonly interpreted as time estimates.  Thusly, "branches" effectively describe
the "body", not nodes themselves.

I advise and lay out a system based on a formal Phylogenetic Tree that implement
Show-Hide Options.

Show All (currently: Show All [unchanged])
Show Offsprings (currently: Show Children)
Show Descendants  (currently: Show Branches)
Show Sub-Tree (currently: Show Subtree [unchanged])
Show Common Level (currently: Hide Sublevels)

Hide Sub-Branches (currently: Hide Leaves - meaning Hide Body after heading)
Hide Branches (currently: Hide Body, leaves all headings visible)
Hide Current Branch (currently: Hide Entry - hide body of this heading)
Hide Sub-Tree (currently: Hide Subtree [unchanged])
Hide Other (currently: Hide Other [unchanged])

Regards
Peter






^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-22  7:56 bug#48580: Outline Mode using Phylogenetic Tree Nomenclature pietru
@ 2021-05-22  8:10 ` Eli Zaretskii
  2021-05-22  8:41   ` pietru
                     ` (2 more replies)
  0 siblings, 3 replies; 11+ messages in thread
From: Eli Zaretskii @ 2021-05-22  8:10 UTC (permalink / raw)
  To: pietru; +Cc: 48580

> From: pietru@caramail.com
> Date: Sat, 22 May 2021 09:56:15 +0200
> Sensitivity: Normal
> 
> I advise and lay out a system based on a formal Phylogenetic Tree that implement
> Show-Hide Options.
> 
> Show All (currently: Show All [unchanged])
> Show Offsprings (currently: Show Children)
> Show Descendants  (currently: Show Branches)
> Show Sub-Tree (currently: Show Subtree [unchanged])
> Show Common Level (currently: Hide Sublevels)
> 
> Hide Sub-Branches (currently: Hide Leaves - meaning Hide Body after heading)
> Hide Branches (currently: Hide Body, leaves all headings visible)
> Hide Current Branch (currently: Hide Entry - hide body of this heading)
> Hide Sub-Tree (currently: Hide Subtree [unchanged])
> Hide Other (currently: Hide Other [unchanged])

FWIW, if I were presented with the menu labels as you suggest, I'd be
mightily confused by the unfamiliar terminology.  "Branches",
"Levels", "Children", and "Tree" are familiar terms when dealing with
tree structures, whereas "Offsprings", "Descendants" and
"Sub-branches" aren't.





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-22  8:10 ` Eli Zaretskii
@ 2021-05-22  8:41   ` pietru
  2021-05-22 10:53   ` pietru
  2021-05-25 20:09   ` Lars Ingebrigtsen
  2 siblings, 0 replies; 11+ messages in thread
From: pietru @ 2021-05-22  8:41 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 48580

The more familiar (emacs) names can be put in the description and mouse pop-up description.
But internally, a more formal system implemented.

I do not see that developers thought about tree structures in a formal manner
(e.g. leaves, branches).  Leaves are not bodies, and branches are not subheadings.

We are getting even more people thinking badly about tree structures, and having
other developers get used to faulty nomenclature.

What can be changed so that there could be some changes that can be handled, but not
too excessive?  There exists a really thought up system that outline should adopt.
It would need documentation for others to understand.

There can also be a deprecation process.

Regards
Peter

> Sent: Saturday, May 22, 2021 at 8:10 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: pietru@caramail.com
> Cc: 48580@debbugs.gnu.org
> Subject: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> > From: pietru@caramail.com
> > Date: Sat, 22 May 2021 09:56:15 +0200
> > Sensitivity: Normal
> >
> > I advise and lay out a system based on a formal Phylogenetic Tree that implement
> > Show-Hide Options.
> >
> > Show All (currently: Show All [unchanged])
> > Show Offsprings (currently: Show Children)
> > Show Descendants  (currently: Show Branches)
> > Show Sub-Tree (currently: Show Subtree [unchanged])
> > Show Common Level (currently: Hide Sublevels)
> >
> > Hide Sub-Branches (currently: Hide Leaves - meaning Hide Body after heading)
> > Hide Branches (currently: Hide Body, leaves all headings visible)
> > Hide Current Branch (currently: Hide Entry - hide body of this heading)
> > Hide Sub-Tree (currently: Hide Subtree [unchanged])
> > Hide Other (currently: Hide Other [unchanged])
>
> FWIW, if I were presented with the menu labels as you suggest, I'd be
> mightily confused by the unfamiliar terminology.  "Branches",
> "Levels", "Children", and "Tree" are familiar terms when dealing with
> tree structures, whereas "Offsprings", "Descendants" and
> "Sub-branches" aren't.
>
>
>
>





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-22  8:10 ` Eli Zaretskii
  2021-05-22  8:41   ` pietru
@ 2021-05-22 10:53   ` pietru
  2021-05-22 11:47     ` Christopher Dimech
  2021-05-25 20:09   ` Lars Ingebrigtsen
  2 siblings, 1 reply; 11+ messages in thread
From: pietru @ 2021-05-22 10:53 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: 48580



> Sent: Saturday, May 22, 2021 at 8:10 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: pietru@caramail.com
> Cc: 48580@debbugs.gnu.org
> Subject: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> > From: pietru@caramail.com
> > Date: Sat, 22 May 2021 09:56:15 +0200
> > Sensitivity: Normal
> >
> > I advise and lay out a system based on a formal Phylogenetic Tree that implement
> > Show-Hide Options.
> >
> > Show All (currently: Show All [unchanged])
> > Show Offsprings (currently: Show Children)
> > Show Descendants  (currently: Show Branches)
> > Show Sub-Tree (currently: Show Subtree [unchanged])
> > Show Common Level (currently: Hide Sublevels)
> >
> > Hide Sub-Branches (currently: Hide Leaves - meaning Hide Body after heading)
> > Hide Branches (currently: Hide Body, leaves all headings visible)
> > Hide Current Branch (currently: Hide Entry - hide body of this heading)
> > Hide Sub-Tree (currently: Hide Subtree [unchanged])
> > Hide Other (currently: Hide Other [unchanged])
>
> FWIW, if I were presented with the menu labels as you suggest, I'd be
> mightily confused by the unfamiliar terminology.  "Branches",
> "Levels", "Children", and "Tree" are familiar terms when dealing with
> tree structures, whereas "Offsprings", "Descendants" and
> "Sub-branches" aren't.

The problem is not much about Levels, Children, and Tree.

Things got problematic when people required additional words for showing and hiding
structures that go beyond Children, Levels and Tree.  My focus is mostly about "Entry"
and Leaves.

Leaves are always end-nodes, not related to the body ("hide leaves" means "hide bodies"
in outline.el [in addition to not being related to end-nodes either]).  In outline, leaves
are expected to be the bodies of headlines.  And even in standard tree nomenclature, branches
are not nodes (but "show branches means" "show nodes" in outline.el).

Regards
Peter


>
>
>





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-22 10:53   ` pietru
@ 2021-05-22 11:47     ` Christopher Dimech
  0 siblings, 0 replies; 11+ messages in thread
From: Christopher Dimech @ 2021-05-22 11:47 UTC (permalink / raw)
  To: pietru; +Cc: 48580

> Sent: Saturday, May 22, 2021 at 10:53 PM
> From: pietru@caramail.com
> To: "Eli Zaretskii" <eliz@gnu.org>
> Cc: 48580@debbugs.gnu.org
> Subject: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> > Sent: Saturday, May 22, 2021 at 8:10 PM
> > From: "Eli Zaretskii" <eliz@gnu.org>
> > To: pietru@caramail.com
> > Cc: 48580@debbugs.gnu.org
> > Subject: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
> >
> > > From: pietru@caramail.com
> > > Date: Sat, 22 May 2021 09:56:15 +0200
> > > Sensitivity: Normal
> > >
> > > I advise and lay out a system based on a formal Phylogenetic Tree that implement
> > > Show-Hide Options.
> > >
> > > Show All (currently: Show All [unchanged])
> > > Show Offsprings (currently: Show Children)
> > > Show Descendants  (currently: Show Branches)
> > > Show Sub-Tree (currently: Show Subtree [unchanged])
> > > Show Common Level (currently: Hide Sublevels)
> > >
> > > Hide Sub-Branches (currently: Hide Leaves - meaning Hide Body after heading)
> > > Hide Branches (currently: Hide Body, leaves all headings visible)
> > > Hide Current Branch (currently: Hide Entry - hide body of this heading)
> > > Hide Sub-Tree (currently: Hide Subtree [unchanged])
> > > Hide Other (currently: Hide Other [unchanged])
> >
> > FWIW, if I were presented with the menu labels as you suggest, I'd be
> > mightily confused by the unfamiliar terminology.  "Branches",
> > "Levels", "Children", and "Tree" are familiar terms when dealing with
> > tree structures, whereas "Offsprings", "Descendants" and
> > "Sub-branches" aren't.
>
> The problem is not much about Levels, Children, and Tree.
>
> Things got problematic when people required additional words for showing and hiding
> structures that go beyond Children, Levels and Tree.  My focus is mostly about "Entry"
> and Leaves.
>
> Leaves are always end-nodes, not related to the body ("hide leaves" means "hide bodies"
> in outline.el [in addition to not being related to end-nodes either]).  In outline, leaves
> are expected to be the bodies of headlines.  And even in standard tree nomenclature, branches
> are not nodes (but "show branches means" "show nodes" in outline.el).

The arguments you brought up are fundamentally correct.  Instead of "branches", outline.el
could use "bodies".  "leaves" and "entry" should also be changed.   "Hide Entry" is really
"Hide Current Body".

And "Hide Body" hides all bodies in buffer, but essentially means "Show Tree" (show headlines
only without displaying bodies).







^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-22  8:10 ` Eli Zaretskii
  2021-05-22  8:41   ` pietru
  2021-05-22 10:53   ` pietru
@ 2021-05-25 20:09   ` Lars Ingebrigtsen
  2021-05-25 20:15     ` pietru
  2 siblings, 1 reply; 11+ messages in thread
From: Lars Ingebrigtsen @ 2021-05-25 20:09 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: pietru, 48580

Eli Zaretskii <eliz@gnu.org> writes:

> FWIW, if I were presented with the menu labels as you suggest, I'd be
> mightily confused by the unfamiliar terminology.  "Branches",
> "Levels", "Children", and "Tree" are familiar terms when dealing with
> tree structures, whereas "Offsprings", "Descendants" and
> "Sub-branches" aren't.

I agree, so I don't think we should change anything here.  Closing.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-25 20:09   ` Lars Ingebrigtsen
@ 2021-05-25 20:15     ` pietru
  2021-05-26 11:57       ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: pietru @ 2021-05-25 20:15 UTC (permalink / raw)
  To: Lars Ingebrigtsen; +Cc: 48580



> Sent: Wednesday, May 26, 2021 at 8:09 AM
> From: "Lars Ingebrigtsen" <larsi@gnus.org>
> To: "Eli Zaretskii" <eliz@gnu.org>
> Cc: pietru@caramail.com, 48580@debbugs.gnu.org
> Subject: Re: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> Eli Zaretskii <eliz@gnu.org> writes:
>
> > FWIW, if I were presented with the menu labels as you suggest, I'd be
> > mightily confused by the unfamiliar terminology.  "Branches",
> > "Levels", "Children", and "Tree" are familiar terms when dealing with
> > tree structures, whereas "Offsprings", "Descendants" and
> > "Sub-branches" aren't.
>
> I agree, so I don't think we should change anything here.  Closing.

Could there be something else than leaves, because it actually hides the current body,
and "hide body" hides all bodies.

> --
> (domestic pets only, the antidote for overdose, milk.)
>    bloggy blog: http://lars.ingebrigtsen.no
>





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-25 20:15     ` pietru
@ 2021-05-26 11:57       ` Eli Zaretskii
  2021-05-26 12:23         ` pietru
  0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2021-05-26 11:57 UTC (permalink / raw)
  To: pietru; +Cc: larsi, 48580

> From: pietru@caramail.com
> Cc: Eli Zaretskii <eliz@gnu.org>, 48580@debbugs.gnu.org
> Date: Tue, 25 May 2021 22:15:06 +0200
> 
> Could there be something else than leaves, because it actually hides the current body,
> and "hide body" hides all bodies.

What would you suggest instead of "Hide leaves"?





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-26 11:57       ` Eli Zaretskii
@ 2021-05-26 12:23         ` pietru
  2021-05-27  7:37           ` Eli Zaretskii
  0 siblings, 1 reply; 11+ messages in thread
From: pietru @ 2021-05-26 12:23 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: larsi, 48580



> Sent: Wednesday, May 26, 2021 at 11:57 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: pietru@caramail.com
> Cc: larsi@gnus.org, 48580@debbugs.gnu.org
> Subject: Re: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> > From: pietru@caramail.com
> > Cc: Eli Zaretskii <eliz@gnu.org>, 48580@debbugs.gnu.org
> > Date: Tue, 25 May 2021 22:15:06 +0200
> >
> > Could there be something else than leaves, because it actually hides the current body,
> > and "hide body" hides all bodies.
>
> What would you suggest instead of "Hide leaves"?

What do you think of the following

"Hide Internal bodies", "Hide Inner Bodies", "Hide Connected Bodies"






^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-26 12:23         ` pietru
@ 2021-05-27  7:37           ` Eli Zaretskii
  2021-05-27  7:42             ` pietru
  0 siblings, 1 reply; 11+ messages in thread
From: Eli Zaretskii @ 2021-05-27  7:37 UTC (permalink / raw)
  To: pietru; +Cc: larsi, 48580

> From: pietru@caramail.com
> Cc: larsi@gnus.org, 48580@debbugs.gnu.org
> Date: Wed, 26 May 2021 14:23:17 +0200
> 
> > > Could there be something else than leaves, because it actually hides the current body,
> > > and "hide body" hides all bodies.
> >
> > What would you suggest instead of "Hide leaves"?
> 
> What do you think of the following
> 
> "Hide Internal bodies", "Hide Inner Bodies", "Hide Connected Bodies"

How about "Hide Subtree's Bodies"?





^ permalink raw reply	[flat|nested] 11+ messages in thread

* bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
  2021-05-27  7:37           ` Eli Zaretskii
@ 2021-05-27  7:42             ` pietru
  0 siblings, 0 replies; 11+ messages in thread
From: pietru @ 2021-05-27  7:42 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: larsi, 48580



> Sent: Thursday, May 27, 2021 at 7:37 PM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: pietru@caramail.com
> Cc: larsi@gnus.org, 48580@debbugs.gnu.org
> Subject: Re: bug#48580: Outline Mode using Phylogenetic Tree Nomenclature
>
> > From: pietru@caramail.com
> > Cc: larsi@gnus.org, 48580@debbugs.gnu.org
> > Date: Wed, 26 May 2021 14:23:17 +0200
> >
> > > > Could there be something else than leaves, because it actually hides the current body,
> > > > and "hide body" hides all bodies.
> > >
> > > What would you suggest instead of "Hide leaves"?
> >
> > What do you think of the following
> >
> > "Hide Internal bodies", "Hide Inner Bodies", "Hide Connected Bodies"
>
> How about "Hide Subtree's Bodies"?

Good too





^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2021-05-27  7:42 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-22  7:56 bug#48580: Outline Mode using Phylogenetic Tree Nomenclature pietru
2021-05-22  8:10 ` Eli Zaretskii
2021-05-22  8:41   ` pietru
2021-05-22 10:53   ` pietru
2021-05-22 11:47     ` Christopher Dimech
2021-05-25 20:09   ` Lars Ingebrigtsen
2021-05-25 20:15     ` pietru
2021-05-26 11:57       ` Eli Zaretskii
2021-05-26 12:23         ` pietru
2021-05-27  7:37           ` Eli Zaretskii
2021-05-27  7:42             ` pietru

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).