Description

A typical <str-Shapes /> program -

Let us discuss the big picture of a typical graphics mode program. (Recall that graphics mode means that compilation of this program will result in graphics.)

Let us discuss the big picture of a typical shape mode program. (Recall that shape mode means that compilation of this program will result in graphics.)

First, a typical program will list a couple of standard extensions, with the ##needs preprocessor directive.

 
@@ -73,7 +73,7 @@ b: [putblockFarRight •page [longblock (TeX `$\bm{b}$´)] a]
 ignore [] [connect •page a b]]]>

Unless something is out of sync, the whole program is included in the example below.

- + ]]> @@ -92,15 +92,15 @@ ignore [] [connect •page a b]]]> -In graphics mode, this would not be a valid program since no graphics is produced. The reason is that is primarily designed for graphics tasks, and in graphics mode it should generally be considered an indication of failure if no graphics is produced.

+In shape mode, this would not be a valid program since no graphics is produced. The reason is that is primarily designed for graphics tasks, and in shape mode it should generally be considered an indication of failure if no graphics is produced.

To solve the problem, the primary option would be to run the program in blank mode, by naming the input file with the .blank suffix.

The secondary option would be to end the program with any simple expression that evaluates to a , for instance

-
+

-The comment makes it clear that the expression has nothing to do with the main purpose of the program. One advantage of this solution is that the program will work both in graphics mode and in blank mode. The complete program is given in the example below. +The comment makes it clear that the expression has nothing to do with the main purpose of the program. One advantage of this solution is that the program will work both in shape mode and in blank mode. The complete program is given in the example below.

- + ]]> @@ -109,7 +109,7 @@ The comment makes it clear that the expression has nothing to do with the main p ]]> -

A text-producing program in graphics mode must produce graphics as well.

A text-producing program in shape mode must produce graphics as well.

diff --git a/doc/parts/structure/chap-result.sxml b/doc/parts/structure/chap-result.sxml index 2bab5c97..c728f2fa 100644 --- a/doc/parts/structure/chap-result.sxml +++ b/doc/parts/structure/chap-result.sxml @@ -18,14 +18,14 @@

Program result -

The compiler will run either in graphics mode or in blank mode, typically determined by the suffix of the input filename.

The compiler will run either in shape mode or in blank mode, typically determined by the suffix of the input filename.

-Graphics mode +

+Shape mode -

Graphics mode is selected for input files with suffix .shapes, or when in doubt.

In graphics mode, the only necessary aspect to discuss regarding the global structure of a program is how the graphical output is defined. There are three means for defining the output of a program: +

Shape mode is selected for input files with suffix .shapes, or when in doubt.

In shape mode, the only necessary aspect to discuss regarding the global structure of a program is how the graphical output is defined. There are three means for defining the output of a program:

Through the value of the program as an expression. If the program results in a non- value, it must be a , and not a null-picture. The result will be a single-page document.
Through a non-empty final value of . For single-page documents. This is equivalent to ending the program with the expression ().

It is illegal to both add pages to and let the program evaluate to a value. The other combinations are allowed by giving precedence to and program value over . Hence, is only used when it is the only alternative in use.

The rationale behind the precedence rule is that may be used to define pages of multi-page documents, and then the rule relieves us from having to clear at the end of the program. Similarly, if one finds that the final content of needs to be transformed for some reason, one may apply the transform to () at the end of the program, without having to clear .

Blank mode diff --git a/source/main.cc b/source/main.cc index 47ee7f3f..d330aed7 100644 --- a/source/main.cc +++ b/source/main.cc @@ -51,7 +51,7 @@ main( int argc, char ** argv ) bool useResources = true; bool interactiveMode = false; bool forceBlankMode = false; - bool forceGraphicsMode = false; + bool forceShapeMode = false; { char * cwd = getcwd( 0, 0 ); @@ -227,21 +227,21 @@ main( int argc, char ** argv ) } else if( strcmp( *argv, "--blank") == 0 ) { - if( forceGraphicsMode ){ - std::cerr << "Conflicting forcing of both blank mode and graphics mode." << std::endl ; + if( forceShapeMode ){ + std::cerr << "Conflicting forcing of both blank mode and shape mode." << std::endl ; exit( Interaction::EXIT_INVOCATION_ERROR ); } forceBlankMode = true; argv += 1; argc -= 1; } - else if( strcmp( *argv, "--graphics") == 0 ) + else if( strcmp( *argv, "--shape") == 0 ) { if( forceBlankMode ){ - std::cerr << "Conflicting forcing of both blank mode and graphics mode." << std::endl ; + std::cerr << "Conflicting forcing of both blank mode and shape mode." << std::endl ; exit( Interaction::EXIT_INVOCATION_ERROR ); } - forceGraphicsMode = true; + forceShapeMode = true; argv += 1; argc -= 1; } @@ -904,7 +904,7 @@ main( int argc, char ** argv ) if( ! forceBlankMode ){ suffixes.push_back( "shape" ); } - if( ! forceGraphicsMode ){ + if( ! forceShapeMode ){ suffixes.push_back( "blank" ); } struct stat theStat; @@ -1041,7 +1041,7 @@ main( int argc, char ** argv ) if( ! forceBlankMode ){ suffixes.push_back( "shape" ); } - if( ! forceGraphicsMode ){ + if( ! forceShapeMode ){ suffixes.push_back( "blank" ); } SuffixesType::const_iterator i = suffixes.begin( ); @@ -1082,7 +1082,7 @@ main( int argc, char ** argv ) if( forceBlankMode ) { Interaction::blankMode = true; - } else if( forceGraphicsMode ){ + } else if( forceShapeMode ){ Interaction::blankMode = false; } else { Interaction::blankMode = ( inputName.size() >= 6 && inputName.compare(inputName.size() - 6, std::string::npos, ".blank") == 0 ); -- 2.11.4.GIT