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


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.

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