Subject: bug#34504: 'pp' causally mentioned

From: Eli Zaretskii <[email-masked]>
Date: Sun, 17 Feb 2019 17:28:12 +0200

tags 34504 notabug
thanks

> From: 積丹尼 Dan Jacobson
> 	<[email-masked]>
> Date: Sun, 17 Feb 2019 03:33:50 +0800
> 
> In (info "(emacs) Program Indent") it says:
>    Emacs also provides a Lisp pretty-printer in the ‘pp’ package, which
> reformats Lisp objects with nice-looking indentation."
> 
> OK, as there is no hyperlink to click on

In my version of the manual, that sentence is followed by a hyperlink:

     Emacs also provides a Lisp pretty-printer in the ‘pp’ package, which
  reformats Lisp objects with nice-looking indentation.  *Note pp:
  (elisp)Output Functions.

> say the user eventually finds
> that indeed there is
> $ dlocate /pp\\.
> emacs-el: /usr/share/emacs/26.1/lisp/emacs-lisp/pp.el.gz
> and loads it, but he still cannot use it because there is no further
> example of how, provided, even within that file. E.g., you could mention
> how to pretty print one's .emacs with it.

pp doesn't by itself pretty-print files, it can only pretty-print Lisp
objects (as the hyperlinked node of the ELisp manual describes).