Re: Major and minor modes

[Jean-Christophe Helary <jean.christophe.helary@gmail.com>]

As I just wrote, "That discrepancy is a bit weird." *especially* since the Info mode has groupings that don't even correspond to the PDF or the HTML...

I really think we should have more consistency in the way the manual is "visually" structured regardless of the format.

(And really, the 50+ pages of the "extra features" not being included in the 600+ pages manual *is* extra weird. If the issue were really to save on paper, we'd have a better balance between the manual and the extra features.)

Jean-Christophe 

> On Jun 15, 2017, at 6:58, Jean-Christophe Helary <jean.christophe.helary@gmail.com> wrote:
> 
> 
>> On Jun 14, 2017, at 23:23, Eli Zaretskii <eliz@gnu.org> wrote:
>> 
>>> From: Jean-Christophe Helary <jean.christophe.helary@gmail.com>
>>> Date: Wed, 14 Jun 2017 12:49:21 +0900
>>> 
>>> Interesting. I just noticed that the HTML and the PDF do not have the same chapter numbering.
>> 
>> I think that's because the PDF version is produced like a printed
>> manual would be, which means some of the stuff is excluded, while the
>> HTML version includes everything, like the Info version would.
> 
> It's different.
> 
> PDF Chapter 2 "Characters, Keys and Commands" has:
> [introductory text about the chapter]
> 2.1 Kinds of User Input
> 2.2 Keys
> 2.3 Keys and Commands
> 
> but the HTML has:
> • 2 Kinds of User Input
> • 3 Keys
> • 4 Keys and Commands
> 
> So in the HTML, PDF sub-chapters are chapters on their own and the introductory text is not present:
> "This chapter explains the character sets used by Emacs for input commands, and the fundamental concepts of keys and commands, whereby Emacs interprets your keyboard and mouse input."
> 
> PDF Chapter 3 "Entering and Exiting Emacs" corresponds to HTML
> • 5 Entering Emacs
> • 6 Exiting Emacs
> 
> Then, until we reach PDF Chapter 31 "Miscellaneous Commands", everything corresponds and the HTML has introductory texts for each chapter just like the PDF.
> PDF 31 corresponds to HTML
> • 34 Gnus
> • 35 Host Security
> • 36 Network Security
> • 37 Document Viewing
> • 38 Web Browsing with EWW
> • 39 Embedded WebKit Widgets
> • 40 Running Shell Commands from Emacs
> • 41 Using Emacs as a Server
> • 42 Printing Hard Copies
> • 43 Sorting Text
> • 44 Editing Pictures
> • 45 Editing Binary Files
> • 46 Saving Emacs Sessions
> • 47 Recursive Editing Levels
> • 48 Hyperlinking and Navigation Features
> • 49 Other Amusements
> 
> which were the subject of a recent discussion on emacs-devel btw.
> 
> Then PDF has:
> 32 Emacs Lisp Packages................................. 431
> 33 Customization ...................................... 436
> 34 Dealing with Common Problems ....................... 468
> 
> And that chapter 34 corresponds to HTML
> • 52 Quitting and Aborting
> • 53 Dealing with Emacs Trouble
> • 54 Reporting Bugs
> • 55 Contributing to Emacs Development
> • 56 How To Get Help with GNU Emacs
> 
> That discrepancy is a bit weird.
> 
> Jean-Christophe