From e5e1c255362e1e4818ad541be850be17ec4be781 Mon Sep 17 00:00:00 2001 From: jsm28 Date: Mon, 11 Jun 2001 12:05:10 +0000 Subject: [PATCH] * doc/objc.texi: Use more logical markup. Use TeX dashes. git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@43182 138bc75d-0d04-0410-961f-82ee72b054a4 --- gcc/ChangeLog | 4 ++++ gcc/doc/objc.texi | 30 +++++++++++++++--------------- 2 files changed, 19 insertions(+), 15 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 24d48aff127..20948adc228 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,5 +1,9 @@ 2001-06-11 Joseph S. Myers + * doc/objc.texi: Use more logical markup. Use TeX dashes. + +2001-06-11 Joseph S. Myers + * doc/c-tree.texi: Use more logical markup. 2001-06-11 Joseph S. Myers diff --git a/gcc/doc/objc.texi b/gcc/doc/objc.texi index b2e5c21bfeb..7e0aae12d10 100644 --- a/gcc/doc/objc.texi +++ b/gcc/doc/objc.texi @@ -116,8 +116,8 @@ things: you can write whatever C code you like; @item -you can send messages to Objective-C constant strings (@@"this is a -constant string"); +you can send messages to Objective-C constant strings (@code{@@"this is a +constant string"}); @item you can allocate and send messages to objects whose class is implemented @@ -241,13 +241,13 @@ The non-atomic types are encoded as follows: @multitable @columnfractions .2 .8 @item pointers -@tab @code{'^'} followed by the pointed type. +@tab @samp{^} followed by the pointed type. @item arrays -@tab @code{'['} followed by the number of elements in the array followed by the type of the elements followed by @code{']'} +@tab @samp{[} followed by the number of elements in the array followed by the type of the elements followed by @samp{]} @item structures -@tab @code{'@{'} followed by the name of the structure (or '?' if the structure is unnamed), the '=' sign, the type of the members and by @code{'@}'} +@tab @samp{@{} followed by the name of the structure (or @samp{?} if the structure is unnamed), the @samp{=} sign, the type of the members and by @samp{@}} @item unions -@tab @code{'('} followed by the name of the structure (or '?' if the union is unnamed), the '=' sign, the type of the members followed by @code{')'} +@tab @samp{(} followed by the name of the structure (or @samp{?} if the union is unnamed), the @samp{=} sign, the type of the members followed by @samp{)} @end multitable Here are some types and their encodings, as they are generated by the @@ -317,11 +317,11 @@ Boehm-Demers-Weiser conservative garbage collector. It is available from @w{@uref{http://www.hpl.hp.com/personal/Hans_Boehm/gc/}}. To enable the support for it you have to configure the compiler using an -additional argument, @w{@kbd{--enable-objc-gc}}. You need to have +additional argument, @w{@option{--enable-objc-gc}}. You need to have garbage collector installed before building the compiler. This will build an additional runtime library which has several enhancements to support the garbage collector. The new library has a new name, -@kbd{libobjc_gc.a} to not conflict with the non-garbage-collected +@file{libobjc_gc.a} to not conflict with the non-garbage-collected library. When the garbage collector is used, the objects are allocated using the @@ -331,7 +331,7 @@ where pointers are located inside objects. This information is computed once per class, immediately after the class has been initialized. There is a new runtime function @code{class_ivar_set_gcinvisible()} -which can be used to declare a so-called @strong{weak pointer} +which can be used to declare a so-called @dfn{weak pointer} reference. Such a pointer is basically hidden for the garbage collector; this can be useful in certain situations, especially when you want to keep track of the allocated objects, yet allow them to be @@ -379,7 +379,7 @@ following class does this: @end example Weak pointers are supported through a new type character specifier -represented by the @code{'!'} character. The +represented by the @samp{!} character. The @code{class_ivar_set_gcinvisible()} function adds or removes this specifier to the string type description of the instance variable named as argument. @@ -390,7 +390,7 @@ as argument. GNU Objective-C provides constant string objects that are generated directly by the compiler. You declare a constant string object by -prefixing a C constant string with the character @code{@@}: +prefixing a C constant string with the character @samp{@@}: @example id myString = @@"this is a constant string object"; @@ -403,8 +403,8 @@ runtime. To get the definition of this class you must include the User defined libraries may want to implement their own constant string class. To be able to support them, the GNU Objective-C compiler provides -a new command line options @code{-fconstant-string-class=}. The provided class should adhere to a strict structure, the same +a new command line options @option{-fconstant-string-class=@var{class-name}}. +The provided class should adhere to a strict structure, the same as @code{NXConstantString}'s structure: @example @@ -422,7 +422,7 @@ User class libraries may choose to inherit the customized constant string class from a different class than @code{Object}. There is no requirement in the methods the constant string class has to implement. -When a file is compiled with the @code{-fconstant-string-class} option, +When a file is compiled with the @option{-fconstant-string-class} option, all the constant string objects will be instances of the class specified as argument to this option. It is possible to have multiple compilation units referring to different constant string classes, neither the @@ -447,7 +447,7 @@ tells the compiler that each time it encounters @code{WOApplication} as a class name, it should replace it with @code{GSWApplication} (that is, @code{WOApplication} is just an alias for @code{GSWApplication}). -There are some constraints on how this can be used - +There are some constraints on how this can be used--- @itemize @bullet -- 2.11.4.GIT