Function: allout-new-exposure

allout-new-exposure is a macro defined in allout.el.gz.

Signature

(allout-new-exposure &rest SPEC)

Documentation

Literal frontend for allout-expose-topic, doesn't evaluate arguments.

Some arguments that would need to be quoted in allout-expose-topic need not be quoted in allout-new-exposure.

Cursor is left at start position.

Use this instead of obsolete allout-exposure.

Examples:
(allout-new-exposure (-1 () () () 1) 0)
Close current topic at current level so only the immediate
subtopics are shown, except also show the children of the
third subtopic; and close the next topic at the current level.
(allout-new-exposure : -1 0)
Close all topics at current level to expose only their
immediate children, except for the last topic at the current
level, in which even its immediate children are hidden.
(allout-new-exposure -2 : -1 *)
        Expose children and grandchildren of first topic at current
level, and expose children of subsequent topics at current
level *except* for the last, which should be opened completely.

Source Code

;; Defined in /usr/src/emacs/lisp/allout.el.gz
;;;_   > allout-new-exposure '()
(defmacro allout-new-exposure (&rest spec)
  "Literal frontend for `allout-expose-topic', doesn't evaluate arguments.
Some arguments that would need to be quoted in `allout-expose-topic'
need not be quoted in `allout-new-exposure'.

Cursor is left at start position.

Use this instead of obsolete `allout-exposure'.

Examples:
\(allout-new-exposure (-1 () () () 1) 0)
	Close current topic at current level so only the immediate
	subtopics are shown, except also show the children of the
	third subtopic; and close the next topic at the current level.
\(allout-new-exposure : -1 0)
	Close all topics at current level to expose only their
	immediate children, except for the last topic at the current
	level, in which even its immediate children are hidden.
\(allout-new-exposure -2 : -1 *)
        Expose children and grandchildren of first topic at current
	level, and expose children of subsequent topics at current
	level *except* for the last, which should be opened completely."
  `(save-excursion
     (if (not (or (allout-goto-prefix-doublechecked)
		  (allout-next-heading)))
	 (error "allout-new-exposure: Can't find any outline topics"))
     (allout-expose-topic ',spec)))