Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version

pprint-plist-definers

Arguments: configuration

Specifies that Lisp forms beginning with particular symbols should be pretty-printed with each pair of elements on an individual line, after a specified number of initial elements. This is done only if the pprint-plist-pairs-on-separate-lines option is true.

The value is a list where each member is a list of a symbol and an integer for the number of initial elements for forms beginning with that symbol. The initial value is similar to this:

((open-menu 4)(make-texture-info 1)(make-instance 2)(make-window 2))

This causes the pretty printer to print a make-window form, for example, with each initarg and value on its own line, like this:

(make-window :my-window
  :class 'frame-window
  :exterior (make-box 200 100 500 400)
  :scrollbars t
  ... )

One place that this feature is used internally is when generating the source code for recreating a form window in an IDE project, which is saved in a *.bil file. While it is usually not necessary to view this generated code, this functionality makes the code easier for a human to read. The pprint-plist-pairs-on-separate-lines option is bound to true during this procedure, so you don't have to turn it on yourself to ensure that *.bil files are written this way.


Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page was not revised from the 10.0 page.
Created 2019.8.20.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 10.1
Unrevised from 10.0 to 10.1.
10.0 version