api[osx,AppKit] epilogue

" Set comments from text copied from documentation page at
	https://developer.apple.com/library/mac/documentation/Cocoa/Reference/ApplicationKit/ObjC_classic/index.html#classes
  to update the text copy the text of Classes table and paste as source of stream
 Take care of:
	1.- classes w/o comments in the page must have an empty line comment
	2.- replace/remove ’ characters
	3.- replace dash characters w/space (used as no-linebreak separators)
"
|stream|
stream := 'NSObject
NSObject is the root class of most Objective C class hierarchies.
NSAccessibilityElement
This class provides the basic infrastructure required to interact with an accessibility client.
NSAlert
An NSAlert object displays an alert, either as an application modal dialog or as a sheet attached to a document window.
NSAnimation
Objects of the NSAnimation class manage the timing and progress of animations in the user interface.
NSViewAnimation
The NSViewAnimation class, a public subclass of NSAnimation, offers a convenient way to animate multiple views and windows.
NSAnimationContext
NSAnimationContext is analogous to CATransaction and are similar in overall concept to NSGraphicsContext.
NSAppearance
An NSAppearance object represents a file that specifies a standard or custom appearance that applies to a subset of UI elements in an app.
NSBezierPath
An NSBezierPath object allows you to create paths using PostScript style commands.
NSCell
The NSCell class provides a mechanism for displaying text or images in an NSView object without the overhead of a full NSView subclass.
NSActionCell
An NSActionCell defines an active area inside a control (an instance of NSControl or one of its subclasses).
NSButtonCell
The NSButtonCell class is a subclass of NSActionCell used to implement the user interfaces of push buttons, checkboxes (switches), and radio buttons.
NSMenuItemCell
NSMenuItemCell is a class that handles the measurement and display of a single menu item in its encompassing frame.
NSPopUpButtonCell
The NSPopUpButtonCell class defines the visual appearance of pop up buttons that display pop up or pull down menus.
NSDatePickerCell
An NSDatePickerCell instance controls the behavior of an NSDatePicker control, or of a single date picker cell in a matrix.
NSFormCell
The NSFormCell class is used to implement text entry fields in a form.
NSLevelIndicatorCell
NSLevelIndicatorCell is a subclass of NSActionCell that provides several level indicator display styles including: capacity, ranking and relevancy.
NSPathCell
NSPathCell implements the user interface of an NSPathControl object.
NSSegmentedCell
The NSSegmentedCell class implements the appearance and behavior of a horizontal button divided into multiple segments.
NSSliderCell
An NSSliderCell object controls the appearance and behavior of an NSSlider object, or of a single slider in an NSMatrix object.
NSStepperCell
An NSStepperCell object controls the appearance and behavior of an NSStepper object.
NSTextFieldCell
The NSTextFieldCell class adds to the text display capabilities of the NSCell class by allowing you to set the color of both the text and its background.
NSComboBoxCell
NSComboBoxCell is a subclass of NSTextFieldCell used to implement the user interface of “combo boxes” (see NSComboBox for information on how combo boxes look and work).
NSPathComponentCell
The NSPathComponentCell class displays a component of a path.
NSSearchFieldCell
The NSSearchFieldCell class defines the programmatic interface for text fields that are optimized for text based searches.
NSSecureTextFieldCell
NSSecureTextFieldCell works with NSSecureTextField to provide a text field whose value is guarded from user examination.
NSTableHeaderCell
The NSTableHeaderCell class is used by an NSTableHeaderView instance to draw the content of the column headers.
NSTokenFieldCell
NSTokenFieldCell is a subclass of NSTextFieldCell that provides tokenized editing of an array of objects similar to the address field in the Mail application.
NSBrowserCell
The NSBrowserCell class is the subclass of NSCell used by default to display data in the columns of an NSBrowser object.
NSImageCell
An NSImageCell object displays a single image (encapsulated in an NSImage object) in a frame.
NSTextAttachmentCell
NSTextAttachmentCell implements the functionality of the NSTextAttachmentCell protocol.
NSColor
An NSColor object represents a color, which is defined in a color space, each point of which has a set of components (such as red, green, and blue) that uniquely define a color.
NSColorList
An NSColorList object is an ordered list of NSColor objects, identified by keys.
NSColorPicker
The NSColorPicker class is an abstract superclass that implements the NSColorPickingDefault protocol.
NSColorSpace
The NSColorSpace class enables the creation of objects representing custom color spaces.
NSController
NSController is an abstract class that implements the NSEditor and NSEditorRegistration informal protocols required for controller classes.
NSObjectController
NSObjectController is a Cocoa bindings compatible controller class.
NSArrayController
NSArrayController is a bindings compatible class that manages a collection of objects.
NSDictionaryController
NSDictionaryController is a bindings compatible class that manages display and editing of the contents of an NSDictionary object.
NSTreeController
The NSTreeController is a bindings compatible controller that manages a tree of objects.
NSUserDefaultsController
NSUserDefaultsController is a Cocoa bindings compatible controller class.
NSCursor
Instances of the NSCursor class manage the appearance of the cursor.
NSDockTile
The NSDockTile class lets you customize the visual representation for your application s miniaturized windows and application icon as they appear in the Dock.
NSDocument
The NSDocument abstract class defines the interface for OS X documents.
NSPersistentDocument
The NSPersistentDocument class is a subclass of NSDocument that is designed to easily integrate into the Core Data framework.
NSDocumentController
An NSDocumentController object manages an application s documents.
NSDraggingImageComponent
The NSDraggingImageComponent class represents a single object in a dragging item.
NSDraggingItem
The NSDraggingItem class encompasses a single dragged item within an NSDraggingSession instance.
NSDraggingSession
The NSDraggingSession class encompases a drag and drop action and allows modification of the drag while in progress.
NSEvent
An NSEvent object, or simply an event, contains information about an input action such as a mouse click or a key down.
NSFont
NSFont objects represent fonts to an application, providing access to characteristics of the font and assistance in laying out glyphs relative to one another.
NSFontCollection
The NSFontCollection class represents a font collection, that is, a group of font descriptors taken together as a single object.
NSMutableFontCollection
NSMutableFontCollection is a dedicated class that represents a mutable collection of fonts.
NSFontDescriptor
NSFontDescriptor objects provide a mechanism to describe a font with a dictionary of attributes.
NSFontManager
NSFontManager is the center of activity for the font conversion system.
NSGestureRecognizer

NSClickGestureRecognizer

NSMagnificationGestureRecognizer

NSPanGestureRecognizer

NSPressGestureRecognizer

NSRotationGestureRecognizer

NSGlyphGenerator
An NSGlyphGenerator object performs the initial, nominal glyph generation phase in the layout process.
NSGlyphInfo
An NSGlyphInfo object represents a glyph attribute value (NSGlyphInfoAttributeName) in an attributed string (NSAttributedString).
NSGradient
The NSGradient class provides support for drawing gradient fill colors, also known as shadings in Quartz.
NSGraphicsContext
The NSGraphicsContext class is the programmatic interface to objects that represent graphics contexts.
NSHelpManager
The NSHelpManager class provides an approach to displaying online help.
NSImage
The NSImage class is a high level interface for manipulating image data.
NSImageRep
The NSImageRep class is a semiabstract superclass (“semi” because it has some instance variables and implementation of its own).
NSBitmapImageRep
The NSBitmapImageRep class renders an image from bitmap data.
NSCachedImageRep
An NSCachedImageRep object store image data in a form that can be readily transferred to the screen.
NSCIImageRep
An NSCIImageRep object can render an image from a Core Image CIImage instance.
NSCustomImageRep
An NSCustomImageRep object uses a delegate object to render an image.
NSEPSImageRep
An NSEPSImageRep object can render an image from encapsulated PostScript (EPS) code.
NSPDFImageRep
An NSPDFImageRep object can render an image from a PDF format data stream.
NSPICTImageRep
An NSPICTImageRep object renders an image from a PICT format data stream as described in the Carbon QuickDraw Manager documentation.
NSInputManager

NSInputServer

NSLayoutConstraint
A constraint defines a relationship between two attributes of user interface objects that must be satisfied by the constraint based layout system.
NSLayoutManager
An NSLayoutManager object coordinates the layout and display of characters held in an NSTextStorage object.
NSMediaLibraryBrowserController
An NSMediaLibraryBrowserController instance configures and displays a Media Library Browser panel.
NSMenu
The NSMenu class defines an object that manages an application s menus.
NSMenuItem
The NSMenuItem class defines objects that are used as command items in menus.
NSMovie

NSNib
Instances of the NSNib class serve as object wrappers, or containers, for Interface Builder nib files.
NSNibConnector

NSNibControlConnector

NSNibOutletConnector

NSOpenGLContext
All OpenGL calls are rendered into an OpenGL graphics context, which in Cocoa is represented by the NSOpenGLContext class.
NSOpenGLPixelBuffer
The NSOpenGLPixelBuffer class gives Cocoa OpenGL implementations access to accelerated offscreen rendering.
NSOpenGLPixelFormat
To render with OpenGL into an NSOpenGLContext, you must specify the context s pixel format.
NSPageLayout
NSPageLayout is a panel that queries the user for information such as paper type and orientation.
NSParagraphStyle
The NSParagraphStyle class and its subclass NSMutableParagraphStyle encapsulate the paragraph or ruler attributes used by the NSAttributedString classes.
NSMutableParagraphStyle
The NSMutableParagraphStyle class adds methods to its superclass, NSParagraphStyle, for changing the values of the subattributes in a paragraph style attribute.
NSPasteboard
NSPasteboard objects transfer data to and from the pasteboard server.
NSPasteboardItem
NSPasteboardItem is a generic class to represent an item on a pasteboard.
NSPathControlItem

NSPDFInfo
An NSPDFInfo object stores information associated with the creation of a PDF file, such as its URL, tag names, page orientation, and paper size.
NSPDFPanel
An NSPDFPanel object is used to implement a Save or Export as PDF panel that s consistent with the OS X user interface.
NSPredicateEditorRowTemplate
NSPredicateEditorRowTemplate describes available predicates and how to display them.
NSPrinter
An NSPrinter object describes a printer s capabilities.
NSPrintInfo
An NSPrintInfo object stores information that s used to generate printed output.
NSPrintOperation
An NSPrintOperation object controls operations that generate Encapsulated PostScript (EPS) code, Portable Document Format (PDF) code, or print jobs.
NSPrintPanel
An NSPrintPanel object creates the Print panel used to query the user for information about a print job.
NSResponder
NSResponder is an abstract class that forms the basis of event and command processing in the Application Kit.
NSApplication
An NSApplication object manages an app s main event loop in addition to resources used by all of that app s objects.
NSDrawer
An NSDrawer object is a user interface element that contains and displays view objects including NSTextView, NSScrollView, NSBrowser, and other classes that inherit from NSView.
NSPopover
The NSPopover class provides a means to display additional content related to existing content on the screen.
NSView
The NSView class defines the basic drawing, event handling, and printing architecture of an app.
NSBox
The NSBox class implements simple views that can title themselves and draw a border around their content.
NSClipView
An NSClipView contains and scrolls the document view displayed by an NSScrollView.
NSCollectionView
NSCollectionView class displays an array of content as a grid of views.
NSControl
NSControl is an abstract superclass that provides three fundamental features for implementing user interface devices: drawing devices on the screen, responding to user events, and sending action messages.
NSBrowser
This class provides a user interface for displaying and selecting items from a list of data or from hierarchically organized lists of data such as directory paths.
NSButton
The NSButton class is a subclass of NSControl that intercepts mouse down events and sends an action message to a target object when it s clicked or pressed.
NSPopUpButton
The NSPopUpButton class defines objects that implement the pop up and pull down menus of the graphical user interface.
NSStatusBarButton

NSColorWell
An NSColorWell object is an NSControl for selecting and displaying a single color value.
NSDatePicker
NSDatePicker is a subclass of NSControl that provides a user interface for displaying and editing an NSDate object.
NSImageView
An NSImageView object displays a single image from an NSImage object in a frame.
NSLevelIndicator
NSLevelIndicator is a subclass of NSControl that displays a value on a linear scale.
NSMatrix
NSMatrix is a class used for creating groups of NSCell objects that work together in various ways.
NSForm
An NSForm object is a vertical matrix of NSFormCell objects to implement the fields.
NSPathControl
NSPathControl is a subclass of NSControl that represents a file system path or virtual path.
NSRuleEditor
An NSRuleEditor object is a view that allows the user to visually create and configure a list of options which are expressed by the rule editor as a predicate (see Predicate Programming Guide).
NSPredicateEditor
NSPredicateEditor is a subclass of NSRuleEditor that is specialized for editing NSPredicate objects.
NSScroller
An NSScroller object controls scrolling of a document view within the clip view of an NSScrollView instance (or potentially of another kind of container view).
NSSegmentedControl
An NSSegmentedControl object implements a horizontal button made of multiple segments.
NSSlider
An NSSlider object displays a range of values for something in the application.
NSStepper
A stepper consists of two small arrows that can increment and decrement a value that appears beside it, such as a date or time.
NSTableView
An NSTableView object displays data for a set of related records, with rows representing individual records and columns representing the attributes of those records.
NSOutlineView
NSOutlineView is a subclass of NSTableView that uses a row and column format to display hierarchical data that can be expanded and collapsed, such as directories and files in a file system.
NSTextField
An NSTextField object is a kind of NSControl that displays text that the user can select or edit and that sends its action message to its target when the user presses the Return key while editing.
NSComboBox
An NSComboBox is a kind of NSControl that allows you to either enter text directly (as you would with an NSTextField) or click the attached arrow at the right of the combo box and select from a displayed (“pop up”) list of items.
NSSearchField
An NSSearchField object implements a text field control that is optimized for performing text based searches.
NSSecureTextField
NSSecureTextField is a subclass of NSTextField that hides its text from display or other access via the user interface.
NSTokenField
NSTokenField is a subclass of NSTextField that provides tokenized editing similar to the address field in the Mail application.
NSMenuView
The NSMenuView class handles the display of menus on the user s screen.
NSMovieView

NSOpenGLView
An NSOpenGLView object maintains an NSOpenGLPixelFormat and NSOpenGLContext object into which OpenGL calls can be rendered.
NSProgressIndicator
The NSProgressIndicator class lets an application display a progress indicator to show that a lengthy task is under way.
NSQuickDrawView

NSRulerView
An NSRulerView displays a ruler and markers above or to the side of an NSScrollView s document view.
NSScrollView
The NSScrollView class is the central coordinator for the Application Kit s scrolling machinery, composed of this class, and the NSClipView, and NSScroller classes .
NSSplitView
A split view manages the dividers and orientation for a split view controller (an instance of the NSSplitViewController class.
NSStackView
A stack view employs Auto Layout (the system s constraint based layout feature) to arrange and align an array of views according to your specification.
NSTableCellView
The NSTableCellView class is a reusable container view shown for a particular cell in an NSTableView instance that uses rows for content.
NSTableHeaderView
An NSTableHeaderView is used by an NSTableView to draw headers over its columns and to handle mouse events in those headers.
NSTableRowView
The NSTableRowView class is the view shown for a row in an NSTableView.
NSTabView
An NSTabView object provides a convenient way to present information in multiple pages.
NSText
NSText declares the most general programmatic interface for objects that manage text.
NSTextView
The NSTextView class is the front end class to the Application Kit s text system.
NSVisualEffectView
NSVisualEffectView provides support for the user interface effects introduced in OS X Yosemite related to translucency, including “vibrant” appearances.
NSViewController
A view controller manages a view, typically loaded from a nib file.
NSCollectionViewItem
The NSCollectionViewItem class is a view controller subclass that manages the relationship between a compound view and the model object that provides its content.
NSPageController
The NSPageController class is used for controlling swipe navigation and animations between views or view content.
NSSplitViewController
A split view controller manages an array of adjacent child views, and has a split view object for managing dividers between those views.
NSTabViewController

NSTitlebarAccessoryViewController

NSWindow
The NSWindow class defines objects (known as windows) that manage and coordinate the windows an application displays on the screen.
NSPanel
The NSPanel class implements a special kind of window (known as a panel), typically performing an auxiliary function.
NSColorPanel
The NSColorPanel class provides a standard user interface for selecting color in an application.
NSFontPanel
The NSFontPanel class implements the Font panel—a user interface object that displays a list of available fonts, letting the user preview them and change the font used to display text.
NSSavePanel
An NSSavePanel object creates and manages a Save panel and allows you to run the panel in a modal loop.
NSOpenPanel
The NSOpenPanel class provides the Open panel for the Cocoa user interface.
NSWindowController
An NSWindowController object manages a window, usually a window stored in a nib file.
NSRulerMarker
An NSRulerMarker object displays a symbol on an NSRulerView object, indicating a location for whatever graphics element it represents in the client of the ruler view (for example, a margin or tab setting, or the edges of a graphic on the page).
NSRunningApplication
NSRunningApplication is a class to manipulate and provide information for a single instance of an application.
NSScreen
An NSScreen object describes the attributes of a computer s monitor, or screen.
NSShadow
An NSShadow object encapsulates the attributes used to create a drop shadow during drawing operations.
NSSharingService
The NSSharingService class is used to provide a consistent user experience when sharing items on OS X.
NSSharingServicePicker
The NSSharingServicePicker class presents a list of sharing services, so that the user can choose a service to share an item.
NSSound
The NSSound class provides a simple interface for loading and playing audio files.
NSSpeechRecognizer
The NSSpeechRecognizer class is the Cocoa interface to Speech Recognition on OS X.
NSSpeechSynthesizer
The NSSpeechSynthesizer class is the Cocoa interface to Speech Synthesis on OS X.
NSSpellChecker
The NSSpellChecker class provides an interface to the Cocoa spell checking service.
NSSplitViewItem

NSStatusBar
The NSStatusBar class defines an object that manages a collection of NSStatusItem objects displayed within the system wide menu bar.
NSStatusItem
The NSStatusItem class represents the individual elements displayed within an NSStatusBar object.
NSStoryboard
A storyboard encapsulates the design time view controller and window controller graph represented in an Interface Builder storyboard resource file.
NSStoryboardSegue
A storyboard segue specifies a transition or containment relationship between two scenes in a storyboard, where a scene is a view controller or a window controller and a storyboard is an instance of the NSStoryboard class.
NSTableColumn
The NSTableColumn class stores the display characteristics and identifier for a column in an NSTableView instance.
NSTabViewItem
An NSTabViewItem is a convenient way for presenting information in multiple pages.
NSTextAlternatives
NSTextAlternatives is an immutable value class that stores a list of alternatives for a piece of text and communicates the user s selection of an alternative via a notification to your app.
NSTextAttachment
NSTextAttachment objects are used by the NSAttributedString class cluster as the values for attachment attributes (stored in the attributed string under the key named NSAttachmentAttributeName).
NSTextBlock
NSTextBlock objects represent a block of text laid out in a subregion of the text container.
NSTextTable
An NSTextTable object represents a text table as a whole.
NSTextTableBlock
An NSTextTableBlock object represents a text block that appears as a cell in a text table.
NSTextContainer
The NSTextContainer class defines a region where text is laid out.
NSTextFinder
The NSTextFinder class provides an optional search and replace find bar interface inside a view, usually a scroll view.
NSTextInputContext
An NSTextInputContext object represents the Cocoa text input system.
NSTextList
An NSTextList object represents a section of text that forms a single list.
NSTextTab
An NSTextTab object represents a tab in an NSParagraphStyle object, storing an alignment type and location.
NSToolbar
NSToolbar and NSToolbarItem provide the mechanism for a titled window to display a toolbar just below its title bar, as shown below: .
NSToolbarItem
The NSToolbarItem class defines each item contained within a window s NSToolbar instance.
NSToolbarItemGroup
NSToolbarItemGroup is a subclass of NSToolbarItem which contains subitems.
NSTouch
An instance of the NSTouch class is a snapshot of a particular touch at an instant in time.
NSTrackingArea
An NSTrackingArea object defines a region of view that generates mouse tracking and cursor update events when the mouse is over that region.
NSTreeNode
NSTreeNode simplifies the creation and management of trees of objects.
NSTypesetter
NSLayoutManager uses concrete subclasses of this abstract class, NSTypesetter, to perform line layout, which includes word wrapping, hyphenation, and line breaking in either vertical or horizontal rectangles.
NSATSTypesetter
NSATSTypesetter is a concrete subclass of NSTypesetter that places glyphs during the text layout process.
NSWorkspace
An NSWorkspace object responds to app requests to perform a variety of services: .
NSMutableAttributedString
NSMutableAttributedString declares the programmatic interface to objects that manage mutable attributed strings.
NSTextStorage
NSTextStorage is a semiconcrete subclass of NSMutableAttributedString that manages a set of client NSLayoutManager objects, notifying them of any changes to its characters or attributes so that they can relay and redisplay the text as needed.
CAOpenGLLayer
CAOpenGLLayer provides a layer suitable for rendering OpenGL content.
NSOpenGLLayer
NSOpenGLLayer is a subclass of CAOpenGLLayer that is suitable for rendering OpenGL into layers.' stream.
[stream atEnd] whileFalse: [| aName comment cls |
	aName := stream nextLine. comment := '
	',stream nextLine.
	cls := Smalltalk at: aName ifAbsent: [ self print: '// missing class ',aName. nil ].
	(cls notNil and: [ cls comment isNil and: [comment trimBlanks notEmpty]]) ifTrue: [
		cls comment: comment.
		self print: 'smalltalk.',aName,'.comment_("',comment,'");'.
	].
].