view info/dir @ 106395:f2b36fb84bf7

Enhance `c-parse-state' to run efficiently in "brace desserts". * progmodes/cc-mode.el (c-basic-common-init): Call c-state-cache-init. (c-neutralize-syntax-in-and-mark-CPP): Renamed from c-extend-and-neutralize-syntax-in-CPP. Mark each CPP construct by placing `category' properties value 'c-cpp-delimiter at its boundaries. * progmodes/cc-langs.el (c-before-font-lock-function): c-extend-and-neutralize-syntax-in-CPP has been renamed c-neutralize-syntax-in-and-mark-CPP. * progmodes/cc-fonts.el (c-cpp-matchers): Mark template brackets with `category' properties now, not `syntax-table' ones. * progmodes/cc-engine.el (c-syntactic-end-of-macro): A new enhanced (but slower) version of c-end-of-macro that won't land inside a literal or on another awkward character. (c-state-cache-too-far, c-state-cache-start) (c-state-nonlit-pos-interval, c-state-nonlit-pos-cache) (c-state-nonlit-pos-cache-limit, c-state-point-min) (c-state-point-min-lit-type, c-state-point-min-lit-start) (c-state-min-scan-pos, c-state-brace-pair-desert) (c-state-old-cpp-beg, c-state-old-cpp-end): New constants and buffer local variables. (c-state-literal-at, c-state-lit-beg) (c-state-cache-non-literal-place, c-state-get-min-scan-pos) (c-state-mark-point-min-literal, c-state-cache-top-lparen) (c-state-cache-top-paren, c-state-cache-after-top-paren) (c-get-cache-scan-pos, c-get-fallback-scan-pos) (c-state-balance-parens-backwards, c-parse-state-get-strategy) (c-renarrow-state-cache) (c-append-lower-brace-pair-to-state-cache) (c-state-push-any-brace-pair, c-append-to-state-cache) (c-remove-stale-state-cache) (c-remove-stale-state-cache-backwards, c-state-cache-init) (c-invalidate-state-cache-1, c-parse-state-1) (c-invalidate-state-cache): New defuns/defmacros/defsubsts. (c-parse-state): Enhanced and refactored. (c-debug-parse-state): Amended to deal with all the new variables. * progmodes/cc-defs.el (c-<-as-paren-syntax, c-mark-<-as-paren) (c->-as-paren-syntax, c-mark->-as-paren, c-unmark-<->-as-paren): modify to use category text properties rather than syntax-table ones. (c-suppress-<->-as-parens, c-restore-<->-as-parens): new defsubsts to switch off/on the syntactic paren property of C++ template delimiters using the category property. (c-with-<->-as-parens-suppressed): Macro to invoke code with template delims suppressed. (c-cpp-delimiter, c-set-cpp-delimiters, c-clear-cpp-delimiters): New constant/macros which apply category properties to the start and end of preprocessor constructs. (c-comment-out-cpps, c-uncomment-out-cpps): defsubsts which "comment out" the syntactic value of characters in preprocessor constructs. (c-with-cpps-commented-out) (c-with-all-but-one-cpps-commented-out): Macros to invoke code with characters in all or all but one preprocessor constructs "commented out".

This is the file .../info/dir, which contains the
topmost node of the Info hierarchy, called (dir)Top.
The first time you invoke Info you start off looking at this node.

File: dir,	Node: Top	This is the top of the INFO tree

The Info Directory
******************

  The Info Directory is the top-level menu of major Info topics.
  Type "d" in Info to return to the Info Directory.  Type "q" to exit Info.
  Type "?" for a list of Info commands, or "h" to visit an Info tutorial.
  Type "m" to choose a menu item--for instance,
    "mEmacs<Return>" visits the Emacs manual.
  In Emacs Info, you can click mouse button 2 on a menu item
  or cross reference to follow it to its target.
  Each menu line that starts with a * is a topic you can select with "m".
  Every third topic has a red * to help pick the right number to type.

* Menu:

* Info: (info).         How to use the documentation browsing system.

Emacs
* Emacs: (emacs).       The extensible self-documenting text editor.
* Emacs FAQ: (efaq).    Frequently Asked Questions about Emacs.

GNU Emacs Lisp
* Emacs Lisp Intro: (eintr).
                          A simple introduction to Emacs Lisp programming.
* Elisp: (elisp).       The Emacs Lisp Reference Manual.

Emacs editing modes
* Ada mode: (ada-mode). Emacs mode for editing and compiling Ada code.
* CC Mode: (ccmode).    Emacs mode for editing C, C++, Objective-C,
                        Java, Pike, AWK, and CORBA IDL code.
* IDLWAVE: (idlwave).   Major mode and shell for IDL files.
* nXML Mode: (nxml-mode).       XML editing mode with RELAX NG support.
* Org Mode: (org).      Outline-based notes management and organizer

Emacs network features
* EUDC: (eudc).   An Emacs client for directory servers (LDAP, PH).
* Gnus: (gnus).         The newsreader Gnus.
* Mairix: (mairix-el).  Emacs interface to the Mairix mail indexer.
* MH-E: (mh-e).         Emacs interface to the MH mail system.
* Message: (message).   Mail and news composition mode that goes with Gnus.
* Newsticker: (newsticker). A Newsticker for Emacs.
* PGG: (pgg).   Emacs interface to various PGP implementations.
* ERC: (erc).           Powerful, modular, and extensible IRC client for Emacs.
* Rcirc: (rcirc).       Internet Relay Chat (IRC) client.
* SASL: (sasl).         The Emacs SASL library.
* SC: (sc).             Supercite lets you cite parts of messages you're
                          replying to, in flexible ways.
* Sieve: (sieve).               Managing Sieve scripts in Emacs.
* TRAMP: (tramp).                Transparent Remote Access, Multiple Protocol
                                 GNU Emacs remote file access via rsh and rcp.

Emacs misc features
* Autotype: (autotype). Convenient features for text that you enter frequently
                          in Emacs.
* Calc: (calc).         Advanced desk calculator and mathematical tool.
* Dired-X: (dired-x).   Dired Extra Features.
* EasyPG Assistant: (epa).   An Emacs user interface to GNU Privacy Guard.
* Ebrowse: (ebrowse).   A C++ class browser for Emacs.
* EDE: (ede).           The Emacs Development Environment.
* Ediff: (ediff).       A visual interface for comparing and merging programs.
* EIEIO: (eieio).       An object system for Emacs Lisp.
* Eshell: (eshell).     A command shell implemented in Emacs Lisp.
* Flymake: (flymake).   A universal on-the-fly syntax checker.
* Forms: (forms).       Emacs package for editing data bases
                          by filling in forms.
* PCL-CVS: (pcl-cvs).   Emacs front-end to CVS.
* RefTeX: (reftex).     Emacs support for LaTeX cross-references and citations.
* Remember: (remember). Simple information manager for Emacs.
* Semantic: (semantic). Source code parsing utilities for Emacs.
* SES: (ses).       Simple Emacs Spreadsheet
* Speedbar: (speedbar). File/Tag summarizing utility.
* VIP: (vip).           An older VI-emulation for Emacs.
* VIPER: (viper).       The newest Emacs VI-emulation mode.
                          (also, A VI Plan for Emacs Rescue
                           or the VI PERil.)
* WoMan: (woman).       Browse UN*X Manual Pages "W.O. (without) Man".

Emacs lisp libraries
* Auth-source: (auth).  A single configuration for multiple applications.
* CL: (cl).             Partial Common Lisp support for Emacs Lisp.
* D-Bus: (dbus).                Using D-Bus in Emacs.
* Emacs MIME: (emacs-mime).   Emacs MIME de/composition library.
* URL: (url).                 URL loading package.
* Widget: (widget).      The "widget" package used by the Emacs Customization
                           facility.
* SMTP: (smtpmail). Emacs library for sending mail via SMTP.