Re: Major and minor modes

[Jean-Christophe Helary]

> 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