From 8905ee4cd409f22e940747b2dc0347c414011250 Mon Sep 17 00:00:00 2001 From: "Thomas E. Dickey" Date: Fri, 12 Apr 2019 21:17:55 -0400 Subject: fix ``fake quotes'' Signed-off-by: Thomas E. Dickey --- specs/CH01.xml | 24 ++++++++++++------------ specs/CH02.xml | 18 +++++++++--------- specs/CH07.xml | 6 +++--- specs/CH09.xml | 26 +++++++++++++------------- specs/CH10.xml | 18 +++++++++--------- specs/CH13.xml | 18 +++++++++--------- specs/appD.xml | 2 +- 7 files changed, 56 insertions(+), 56 deletions(-) (limited to 'specs') diff --git a/specs/CH01.xml b/specs/CH01.xml index 5dc0d84..b20226e 100644 --- a/specs/CH01.xml +++ b/specs/CH01.xml @@ -48,7 +48,7 @@ for each Intrinsics procedure and describe which operations are defined for the nonwidget superclasses of Core. The reader may determine by context whether a specific reference to widget -actually means ``widget'' or ``object.'' +actually means “widget” or “object.” @@ -109,7 +109,7 @@ and is usually referenced as \-lXt when linking the application. All functions defined in this specification except those specified below may be implemented as C macros with arguments. C applications may use -``#undef'' to remove a macro definition and ensure that the actual function +“#undef” to remove a macro definition and ensure that the actual function is referenced. Any such macro will expand to a single expression that has the same precedence as a function call and that evaluates each of its arguments exactly once, fully protected by parentheses, so that @@ -155,7 +155,7 @@ subclasses. Physically, a widget class is a pointer to a structure. The contents of this structure are constant for all widgets of the widget class but will vary from class to class. -(Here, ``constant'' means the class structure is initialized at compile time +(Here, “constant” means the class structure is initialized at compile time and never changed, except for a one-time class initialization and in-place compilation of resource lists, which takes place when the first widget of the class or subclass is created.) @@ -1261,11 +1261,11 @@ A resource name is spelled identically to the field name except that compound names use capitalization rather than underscore. To let the compiler catch spelling errors, each resource name should have a symbolic identifier prefixed with -``XtN''. +“XtN”. For example, the background_pixmap field has the corresponding identifier XtNbackgroundPixmap, -which is defined as the string ``backgroundPixmap''. +which is defined as the string “backgroundPixmap”. Many predefined names are listed in <X11/StringDefs.h>. Before you invent a new name, @@ -1275,9 +1275,9 @@ you should make sure there is not already a name that you can use. A resource class string starts with a capital letter -and uses capitalization for compound names (for example,``BorderWidth''). +and uses capitalization for compound names (for example,“BorderWidth”). Each resource class string should have a symbolic identifier prefixed with -``XtC'' +“XtC” (for example, XtCBorderWidth). Many predefined classes are listed in <X11/StringDefs.h>. @@ -1286,9 +1286,9 @@ Many predefined classes are listed in A resource representation string is spelled identically to the type name -(for example, ``TranslationTable''). +(for example, “TranslationTable”). Each representation string should have a symbolic identifier prefixed with -``XtR'' +“XtR” (for example, XtRTranslationTable). Many predefined representation types are listed in <X11/StringDefs.h>. @@ -1349,7 +1349,7 @@ Action procedures available to translation specifications should follow the same naming conventions as procedures. That is, they start with a capital letter, and compound names use uppercase -(for example, ``Highlight'' and ``NotifyClient''). +(for example, “Highlight” and “NotifyClient”). @@ -1681,7 +1681,7 @@ inheriting or enveloping a superclass's operations The class_name field contains the text name for this class, which is used by the resource manager. -For example, the Label widget has the string ``Label''. +For example, the Label widget has the string “Label”. More than one widget class can share the same text class name. This string must be permanently allocated prior to or during the execution of the class initialization procedure and must not be @@ -2686,7 +2686,7 @@ result of XrmStringToQuark for a registered string constant. The Intrinsics reserve all record type strings beginning with the two -characters ``XT'' for future standard uses. The value +characters “XT” for future standard uses. The value NULLQUARK may also be used by the class part owner in extension records attached to its own class diff --git a/specs/CH02.xml b/specs/CH02.xml index 00bc7e7..c1bd5e2 100644 --- a/specs/CH02.xml +++ b/specs/CH02.xml @@ -573,7 +573,7 @@ name is the name used to invoke the program. On implementations that conform to ANSI C Hosted Environment support, the application name will be argv[0] less any directory and file type components, that is, the final component of argv[0], if specified. If argv[0] does not exist or -is the empty string, the application name is ``main''. +is the empty string, the application name is “main”. returns the newly opened display or NULL if it failed. @@ -795,7 +795,7 @@ Calls to verify that the current locale is supported. If the locale is not supported, a warning message is issued with -and the locale is set to ``C''. +and the locale is set to “C”. @@ -886,7 +886,7 @@ above in the same order: -A temporary database, the ``server resource database'', is +A temporary database, the “server resource database”, is created from the string returned by XResourceManagerString or, if @@ -900,7 +900,7 @@ preference resource file is $HOME/.Xdefaults. If a language procedure has been set, -first searches the command line for the option ``-xnlLanguage'', or +first searches the command line for the option “-xnlLanguage”, or for a -xrm option that specifies the xnlLanguage/XnlLanguage resource, as specified by Section 2.4. If such a resource is found, the value is assumed to be @@ -1061,7 +1061,7 @@ It may contain sitewide customizations specified by the system manager. The name of the application class resource file is found by calling with the parameters -(display, ``app-defaults'', NULL, NULL, NULL, NULL, 0, NULL). +(display, “app-defaults”, NULL, NULL, NULL, NULL, 0, NULL). This file is expected to be provided by the developer of the application and may be required for the application to function properly. A simple application that wants to be assured of having a minimal @@ -1518,7 +1518,7 @@ in the standard table overrides the standard table entry. If an option name is a prefix of another option name, both names are kept in the merged table. The Intrinsics reserve all option names -beginning with the characters ``-xt'' for future standard uses. +beginning with the characters “-xt” for future standard uses. @@ -1795,9 +1795,9 @@ All Intrinsics interfaces that require ArgList arguments have analogs conforming to the ANSI C variable argument list -(traditionally called ``varargs'') +(traditionally called “varargs”) calling convention. The name of the analog is formed by prefixing -``Va'' to the name of the corresponding +“Va” to the name of the corresponding ArgList procedure; e.g., . @@ -4031,7 +4031,7 @@ Unmanages the widget if the widget is managed. Makes a postorder (child-to-parent) traversal of the widget tree rooted at the specified widget and, for each widget that has -declared a callback list resource named ``unrealizeCallback'', executes the +declared a callback list resource named “unrealizeCallback”, executes the procedures on the XtNunrealizeCallback list. diff --git a/specs/CH07.xml b/specs/CH07.xml index 5756483..737a0b6 100644 --- a/specs/CH07.xml +++ b/specs/CH07.xml @@ -747,7 +747,7 @@ If is invoked multiple times before the Intrinsics are able to invoke the registered callback, the callback is only called once. -Logically, the Intrinsics maintain ``pending'' flag for each registered callback. +Logically, the Intrinsics maintain “pending” flag for each registered callback. This flag is initially False and is set to @@ -760,7 +760,7 @@ or (with a mask including XtIMSignal) -is called, all registered callbacks with ``pending'' +is called, all registered callbacks with “pending” True are invoked and the flags are reset to False. @@ -2504,7 +2504,7 @@ was created. Since on the parent will not modify the resource of the pop-up child, clients are advised to include a resource specification of the form -``*TransientShell.ancestorSensitive: True'' +“*TransientShell.ancestorSensitive: True” in the application defaults resource file or to otherwise ensure that the parent is sensitive when creating pop-up shells. diff --git a/specs/CH09.xml b/specs/CH09.xml index 0f45c42..53eba83 100644 --- a/specs/CH09.xml +++ b/specs/CH09.xml @@ -79,14 +79,14 @@ except all underscores (_) are deleted and the next letter is replaced by its uppercase counterpart. For example, the resource name for background_pixel becomes backgroundPixel. Resource names beginning with the two-character -sequence ``xt'', and resource classes beginning with the two-character -sequence ``Xt'' are reserved to the Intrinsics for future standard and +sequence “xt”, and resource classes beginning with the two-character +sequence “Xt” are reserved to the Intrinsics for future standard and implementation-dependent uses. Widget header files typically contain a symbolic name for each resource name. All resource names, classes, and types used by the Intrinsics are named in <X11/StringDefs.h>. The Intrinsics's symbolic resource names begin with -``XtN'' +“XtN” and are followed by the string name (for example, XtNbackgroundPixel for backgroundPixel). @@ -124,9 +124,9 @@ and everything else darkblue. In this case, the background pixel should have a resource class of -``Background'' +“Background” and all the other pixel entries a resource class of -``Foreground''. +“Foreground”. Then, the resource file needs only two lines to change all pixels to ivory or darkblue: @@ -148,7 +148,7 @@ By convention, resource classes are always spelled starting with a capital letter to distinguish them from resource names. Their symbolic names are preceded with -``XtC'' +“XtC” (for example, XtCBackground). @@ -1467,7 +1467,7 @@ and evaluate this in the following manner: Query the resource database for the resource whose full name -is ``xtDefaultFont'', class ``XtDefaultFont'' (that is, no widget +is “xtDefaultFont”, class “XtDefaultFont” (that is, no widget name/class prefixes), and use a type XtRString value returned as the font name or a type @@ -1508,7 +1508,7 @@ and evaluate this in the following manner: Query the resource database for the resource whose full name -is ``xtDefaultFontSet'', class ``XtDefaultFontSet'' (that is, no widget +is “xtDefaultFontSet”, class “XtDefaultFontSet” (that is, no widget name/class prefixes), and use a type XtRString value returned as the base font name list or a type @@ -1573,14 +1573,14 @@ Alphabetic case is not significant in the conversion. The String-to-CommandArgArray conversion parses a String into an array of strings. White space characters separate elements of the command line. -The converter recognizes the backslash character ``\\'' as an escape +The converter recognizes the backslash character “\\” as an escape character to allow the following white space character to be part of the array element. The String-to-DirectoryString conversion recognizes the -string ``XtCurrentDirectory'' and returns the result of a call +string “XtCurrentDirectory” and returns the result of a call to the operating system to get the current directory. @@ -2164,9 +2164,9 @@ The procedure issues a warning message using -with name ``conversionError'', -type ``string'', class ``XtToolkitError'', and the default message -``Cannot convert "from_value" to type to_type''. +with name “conversionError”, +type “string”, class “XtToolkitError”, and the default message +“Cannot convert "from_value" to type to_type”. diff --git a/specs/CH10.xml b/specs/CH10.xml index 58e6af0..9bc17ed 100644 --- a/specs/CH10.xml +++ b/specs/CH10.xml @@ -192,7 +192,7 @@ is the name of the C procedure that implements that function: The Intrinsics reserve all action names and parameters starting with -the characters ``Xt'' for future standard enhancements. Users, +the characters “Xt” for future standard enhancements. Users, applications, and widgets should not declare action names or pass parameters starting with these characters except to invoke specified built-in Intrinsics functions. @@ -628,8 +628,8 @@ action sequence. Translation table entries may specify actions that are taken when two or more identical events occur consecutively within a short time interval, called the multi-click time. The multi-click time value may -be specified as an application resource with name ``multiClickTime'' and -class ``MultiClickTime'' and may also be modified dynamically by the +be specified as an application resource with name “multiClickTime” and +class “MultiClickTime” and may also be modified dynamically by the application. The multi-click time is unique for each Display value and is retrieved from the resource database by . @@ -949,8 +949,8 @@ augment, or override any existing translation table in the widget. To specify this, a pound sign (#) is given as the first character of the table -followed by one of the keywords ``replace'', ``augment'', or -``override'' to indicate +followed by one of the keywords “replace”, “augment”, or +“override” to indicate whether to replace, augment, or override the existing table. The replace or merge operation is performed during the @@ -959,20 +959,20 @@ instance initialization. Each merge operation produces a new translation resource value; if the original tables were shared by other widgets, they are unaffected. If no directive is -specified, ``#replace'' is assumed. +specified, “#replace” is assumed. At instance initialization the XtNtranslations resource is first fetched. Then, if it was -not specified or did not contain ``#replace'', the +not specified or did not contain “#replace”, the resource database is searched for the resource XtNbaseTranslations. If XtNbaseTranslations is found, it is merged into the widget class translation table. Then the widget translations field is merged into the result or into the class translation table if XtNbaseTranslations was not found. This final table is then stored into the widget translations field. If the XtNtranslations -resource specified ``#replace'', no merge is done. +resource specified “#replace”, no merge is done. If neither XtNbaseTranslations or XtNtranslations are specified, the class translation table is copied into the widget instance. @@ -2030,7 +2030,7 @@ translation table entry only. For both and KeyPress events, don't-care modifiers are ignored unless the translation entry -explicitly specifies ``Any'' in the modifiers field. +explicitly specifies “Any” in the modifiers field. diff --git a/specs/CH13.xml b/specs/CH13.xml index c6a1cdd..530f918 100644 --- a/specs/CH13.xml +++ b/specs/CH13.xml @@ -129,8 +129,8 @@ specification change is small. A composite widget layout routine that calls is now expected to store the complete new geometry in the intended structure; -previously the specification said ``store the changes it intends to -make''. Only by storing the complete geometry does the child have +previously the specification said “store the changes it intends to +make”. Only by storing the complete geometry does the child have any way to know what other parts of the geometry may still be flexible. Existing widgets should not be affected by this, except to take advantage of the new information. @@ -144,7 +144,7 @@ In order to provide a mechanism for widgets to be notified when they become unrealized through a call to , the callback -list name ``unrealizeCallback'' has been defined by the Intrinsics. A +list name “unrealizeCallback” has been defined by the Intrinsics. A widget class that requires notification on unrealize may declare a callback list resource by this name. No class is required to declare this resource, but any class that did so in a prior revision may find @@ -293,7 +293,7 @@ defaults files while still giving end users the ability to augment or override individual event sequences. This change will affect only those applications that wish to take advantage of the new functionality or those widgets that may have previously defined -a resource named ``baseTranslations''. +a resource named “baseTranslations”. @@ -307,8 +307,8 @@ to If it is important to the application to preserve complete compatibility of the defaults file between different versions of the application running under Release 4 and Release 5, -the full translations can be replicated in both the ``translations'' -and the ``baseTranslations'' resource. +the full translations can be replicated in both the “translations” +and the “baseTranslations” resource. @@ -342,8 +342,8 @@ application class resource files according to arbitrary user-specified categories. The primary motivation for this addition was separate monochrome and color application class defaults files. The substitution value is obtained by querying the current resource -database for the application resource name ``customization'', class -``Customization''. Any application that previously used this +database for the application resource name “customization”, class +“Customization”. Any application that previously used this resource name and class will need to be aware of the possibly conflicting semantics. @@ -717,7 +717,7 @@ database construction, by using the new substitution string, %D. The default key translator now recognizes the NumLock modifier. If NumLock is on and the second keysym is a keypad keysym -(a standard keysym named with a ``KP'' prefix or a +(a standard keysym named with a “KP” prefix or a vendor-specific keysym in the hexadecimal range 0x11000000 to 0x1100FFFF), then the default key translator will use the first keysym if Shift and/or ShiftLock is on and will diff --git a/specs/appD.xml b/specs/appD.xml index b863381..a7ac681 100644 --- a/specs/appD.xml +++ b/specs/appD.xml @@ -6,7 +6,7 @@ All Intrinsics errors and warnings have class -``XtToolkitError''. +“XtToolkitError”. The following two tables summarize the common errors and warnings that can be generated by the Intrinsics. Additional implementation-dependent messages are permitted. -- cgit v1.2.1