eXept Software AG Logo

Smalltalk/X Webserver

Documentation of class 'stx_libbasic2':



Class: stx_libbasic2



* Projects & Packages *
rev: 1.184 date: 2019/07/24 06:32:00
user: cg
file: stx_libbasic2.st directory: libbasic2
module: stx stc-classLibrary: libbasic2


Package documentation:

This library contains additional basic (nonGUI) classes.

These are less fundamental as in libbasic and not required by many stand alone applications.
Beside additional container classes, this includes URL support, Zip support,
PTY, serial line, sockets and IP addresses, and other less frequently needed things.

Most real world applications will include this, but it is possible to create
small standAlone apps which do not need it.

[primary maintainer:]

Class protocol:

o  excludedFromPreRequisites
Rc4Cipher - referenced by RandomGenerator class>>new

o  mandatoryPreRequisites
list packages which are mandatory as a prerequisite.
This are packages containing superclasses of my classes and classes which
are extended by myself.
They are mandatory, because we need these packages as a prerequisite for loading and compiling.
This method is generated automatically,
by searching along the inheritance chain of all of my classes.
Please take a look at the #referencedPreRequisites method as well.

o  referencedPreRequisites
list packages which are a prerequisite, because they contain
classes which are referenced by my classes.
These packages are NOT needed as a prerequisite for compiling or loading,
however, a class from it may be referenced during execution and having it
unloaded then may lead to a runtime doesNotUnderstand error, unless the caller
includes explicit checks for the package being present.
This method is generated automatically,
by searching all classes (and their packages) which are referenced by my classes.
Please also take a look at the #mandatoryPreRequisites method

description - compilation
o  additionalBaseAddressDefinition_bc_dot_mak
this is an optional definition, which (if present) may speed up the dll-loading a little
on win32 systems.

o  additionalLinkLibraries_bc_dot_mak

o  additionalLinkLibraries_make_dot_proto

o  additionalRules_bc_dot_mak

o  additionalRules_make_dot_proto

o  additionalTargets_bc_dot_mak

o  additionalTargets_make_dot_proto
(comment from inherited method)
can list additional Make.proto targets (additional unix support files)

o  localIncludes
(comment from inherited method)
allow for the specification of additional include directories

o  stcOptimizationOptions
(comment from inherited method)
see the stc reference / stc usage for options.
Can be redefined in concrete packages.
For now, the following variants are useful:
+optspace3 most compact code
- use for all gui, application code.

+optinline +optinline2 +inlineNew
fastest code
- use only for computation-intensive classes

o  stcWarningOptions

description - contents
o  classNamesAndAttributes
lists the classes which are to be included in the project.
Each entry in the list may be: a single class-name (symbol),
or an array-literal consisting of class name and attributes.
Attributes are: #autoload or #<os> where os is one of win32, unix,...

o  extensionMethodNames
lists the extension methods which are to be included in the project.
Entries are 2-element array literals, consisting of class-name and selector.
A correponding method with real names must be present in my concrete subclasses
if it has extensions.

description - project information
o  companyName
Return a companyname which will appear in <lib>.rc

o  description
Return a description string which will appear in nt.def / bc.def

o  legalCopyright
Return a copyright string which will appear in <lib>.rc

o  productName
Return a product name which will appear in <lib>.rc

ST/X; WebServer 1.670 at bd0aa1f87cdd.unknown:8081; Sun, 04 Jun 2023 16:38:04 GMT