Harmonize ASCII usage across all packages

This commit is contained in:
Mael Rouxel-Labbé 2021-06-23 23:34:14 +02:00
parent a34debc92b
commit 78ff9185b3
74 changed files with 153 additions and 152 deletions

View File

@ -3475,7 +3475,7 @@ This package provides an <I>inserter</I> (the `<<` operator) and an
`Arrangement_2<Traits,Dcel>` class that inserts and an arrangement
object into an output stream and extracts an arrangement object from an
input stream respectively. The arrangement is written using a simple
predefined ASCII format that encodes the arrangement topology, as well
predefined \ascii format that encodes the arrangement topology, as well
as all geometric entities associated with vertices and edges.
The ability to use the input/output operators, requires that the
@ -3560,7 +3560,7 @@ with the basic arrangement structure.
The arrangement package supplies an inserter and an extractor for the
`Arrangement_with_history_2<Traits,Dcel>` class. The arrangement is
represented using a simple predefined ASCII format. An object of the
represented using a simple predefined \ascii format. An object of the
`Arrangement_with_history_2<Traits,Dcel>` type can be saved and
restored, as long as the `Curve_2` type defined by the traits
class - as well as the `Point_2` type and the `X_monotone_curve_2`

View File

@ -27,7 +27,7 @@
namespace CGAL {
/*! \class
* A class defining a textual (ASCII) input/output format for arrangements
* A class defining a textual (\ascii) input/output format for arrangements
* and supports reading and writing an arrangement from or to input/output
* streams.
*/
@ -489,7 +489,7 @@ protected:
};
/*! \class
* A class defining a textual (ASCII) input/output format for arrangements
* A class defining a textual (\ascii) input/output format for arrangements
* that store auxiliary dat with their face records, as they are templated
* by a face-extended DCEL class.
*/
@ -546,7 +546,7 @@ public:
};
/*! \class
* A class defining a textual (ASCII) input/output format for arrangements
* A class defining a textual (\ascii) input/output format for arrangements
* that store auxiliary dat with all their DCEL records, as they are templated
* by a extended DCEL class.
*/

View File

@ -26,7 +26,7 @@
namespace CGAL {
/*! \class
* A class defining a textual (ASCII) input/output format for arrangements
* A class defining a textual (\ascii) input/output format for arrangements
* with history and supports reading and writing an arrangement from or to
* input/output streams.
*/

View File

@ -175,7 +175,7 @@ bool read_PLY(std::istream& is, Graph& g,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -311,7 +311,7 @@ bool read_PLY(const std::string& fname, Graph& g,
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{the precision of the stream `os`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd
@ -482,7 +482,7 @@ bool write_PLY(std::ostream& os, const Graph& g,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -521,7 +521,7 @@ bool write_PLY(std::ostream& os, const Graph& g,
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -135,7 +135,7 @@ bool read_STL(std::istream& is,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -231,7 +231,7 @@ bool read_STL(const std::string& fname, Graph& g) { return read_STL(fname, g, pa
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{the precision of the stream `os`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd
@ -328,7 +328,7 @@ bool write_STL(std::ostream& os,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -346,7 +346,7 @@ bool write_STL(std::ostream& os,
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -393,7 +393,7 @@ void write_polys_points(std::ostream& os,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -492,7 +492,7 @@ bool write_VTP(std::ostream& os,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd

View File

@ -214,7 +214,7 @@ bool read_polygon_mesh(const std::string& fname, Graph& g)
* \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
* \cgalParamType{int}
* \cgalParamDefault{`6`}
* \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
* \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
* \cgalParamNEnd
*
* \cgalParamNBegin{verbose}

View File

@ -84,7 +84,7 @@ Orientation orientation();
/*!
This operator imports a general polygon from the input stream `in`.
Both ASCII and binary formats are supported, and the format is automatically detected.
Both \ascii and binary formats are supported, and the format is automatically detected.
The format consists of the number of points of the outer boundary followed
by the points themselves in counterclockwise order, followed by the number of holes,
@ -100,11 +100,11 @@ std::istream& operator>>(std::istream& in, CGAL::General_polygon_2<ArrTraits>& P
/*!
This operator exports a general polygon to the output stream `out`.
An ASCII and a binary format exist. The format can be selected with
An \ascii and a binary format exist. The format can be selected with
the \cgal modifiers for streams, `set_ascii_mode` and `set_binary_mode`
respectively. The modifier `set_pretty_mode` can be used to allow for (a
few) structuring comments in the output. Otherwise, the output would
be free of comments. The default for writing is ASCII without
be free of comments. The default for writing is \ascii without
comments.
The number of curves of the outer boundary is exported followed by the

View File

@ -847,7 +847,7 @@ operator >> ( std::istream& is, CGAL::Min_annulus_d<Traits_>& min_annulus)
case CGAL::IO::PRETTY:
cerr << endl;
cerr << "Stream must be in ascii or binary mode" << endl;
cerr << "Stream must be in ASCII or binary mode" << endl;
break;
case CGAL::IO::ASCII:

View File

@ -309,7 +309,7 @@ operator >> ( std::istream& is,
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII:

View File

@ -348,7 +348,7 @@ operator >> ( std::istream& is,
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII:

View File

@ -77,7 +77,7 @@ operator >> ( std::istream& is, CGAL::Min_circle_2<Traits_>& min_circle)
case CGAL::IO::PRETTY:
cerr << endl;
cerr << "Stream must be in ascii or binary mode" << endl;
cerr << "Stream must be in ASCII or binary mode" << endl;
break;
case CGAL::IO::ASCII:

View File

@ -60,7 +60,7 @@ operator >> ( std::istream& is, CGAL::Optimisation_circle_2<K_>& c)
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII: {

View File

@ -378,7 +378,7 @@ operator >> ( std::istream& is,
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII:

View File

@ -386,7 +386,7 @@ operator >> ( std::istream& is,
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII:

View File

@ -77,7 +77,7 @@ operator >> ( std::istream& is, CGAL::Min_ellipse_2<Traits_>& min_ellipse)
case CGAL::IO::PRETTY:
cerr << endl;
cerr << "Stream must be in ascii or binary mode" << endl;
cerr << "Stream must be in ASCII or binary mode" << endl;
break;
case CGAL::IO::ASCII:

View File

@ -79,7 +79,7 @@ operator >> ( std::istream& is, CGAL::Optimisation_ellipse_2<K_>& e)
case CGAL::IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case CGAL::IO::ASCII:

View File

@ -77,7 +77,7 @@ operator >> ( std::istream& is, Min_sphere_d<Traits>& min_sphere)
case IO::PRETTY:
std::cerr << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
case IO::ASCII:

View File

@ -93,7 +93,7 @@ typedef enum {
typedef enum {
/** data are binary */
DM_BINARY,
/** data are ascii */
/** data are \ascii */
DM_ASCII
} DATA_MODE;

View File

@ -88,7 +88,7 @@ exemple :
-a age (entier)
-s sexe (1/2)
-l lateralite
-txt texte libre (ascii)
-txt texte libre (ASCII)
-endtxt (fin du texte)

View File

@ -109,19 +109,19 @@ int writeGis( char *name, _image* im) {
switch( im->wordKind ) {
default :
fprintf(stderr, "writeGis: such word kind not handled in ascii mode for file \'%s\'\n", outputName);
fprintf(stderr, "writeGis: such word kind not handled in ASCII mode for file \'%s\'\n", outputName);
if ( outputName != nullptr ) ImageIO_free( outputName );
return( -3 );
case WK_FIXED :
switch ( im->wdim ) {
default :
fprintf(stderr, "writeGis: such word dim not handled in ascii mode for file \'%s\'\n", outputName);
fprintf(stderr, "writeGis: such word dim not handled in ASCII mode for file \'%s\'\n", outputName);
if ( outputName != nullptr ) ImageIO_free( outputName );
return( -3 );
case 1 :
switch ( im->sign ) {
default :
fprintf(stderr, "writeGis: such sign not handled in ascii mode for file \'%s\'\n", outputName);
fprintf(stderr, "writeGis: such sign not handled in ASCII mode for file \'%s\'\n", outputName);
if ( outputName != nullptr ) ImageIO_free( outputName );
return( -3 );
case SGN_UNSIGNED :
@ -169,7 +169,7 @@ int writeGis( char *name, _image* im) {
case 2 :
switch ( im->sign ) {
default :
fprintf(stderr, "writeGis: such sign not handled in ascii mode for file \'%s\'\n", outputName);
fprintf(stderr, "writeGis: such sign not handled in ASCII mode for file \'%s\'\n", outputName);
if ( outputName != nullptr ) ImageIO_free( outputName );
return( -3 );
case SGN_UNSIGNED :
@ -502,7 +502,7 @@ int readGisHeader( const char* name,_image* im)
/* read data if ascii
/* read data if ASCII
only U8 and S8
*/
if ( im->dataMode == DM_ASCII ) {
@ -512,7 +512,7 @@ int readGisHeader( const char* name,_image* im)
int ret, iv=0;
if ( im->wdim != 1 || im->wordKind != WK_FIXED ) {
fprintf(stderr, "readGisHeader: error: unable to read such ascii type\n" );
fprintf(stderr, "readGisHeader: error: unable to read such ASCII type\n" );
return -1;
}
@ -550,7 +550,7 @@ int readGisHeader( const char* name,_image* im)
}
if ( ret != 1 ) {
fprintf( stderr, "readGisHeader: error in reading ascii data\n" );
fprintf( stderr, "readGisHeader: error in reading ASCII data\n" );
ImageIO_free( im->data ); im->data = nullptr;
ImageIO_free( str );
return -1;

View File

@ -366,7 +366,7 @@ int readPgmAsciiImage(const char *name,_image *im)
switch ( im->wordKind ) {
case WK_FIXED :
if ( sscanf( tmp, "%d", &iv ) != 1 ) {
fprintf( stderr, "readAsciiPgmImage: error in reading ascii data\n" );
fprintf( stderr, "readAsciiPgmImage: error in reading ASCII data\n" );
ImageIO_free( im->data ); im->data = nullptr;
return 0;
}

View File

@ -324,7 +324,7 @@ public:
/// @{
/*!
\brief converts a deprecated configuration (in compressed ASCII
\brief converts a deprecated configuration (in compressed \ascii
format) to a new configuration (in binary format).
The input file should be a GZIP container written by the

View File

@ -333,7 +333,7 @@ public:
/// @{
/*!
\brief outputs the evaluation in a simple ASCII format to the stream `os`.
\brief outputs the evaluation in a simple \ascii format to the stream `os`.
*/
friend std::ostream& operator<< (std::ostream& os, const Evaluation& evaluation)
{

View File

@ -237,6 +237,7 @@ ALIASES = "cgal=%CGAL" \
"iso=ISO" \
"lisp=Lisp" \
"ieee=IEEE" \
"ascii=ASCII" \
"exacus=Exacus" \
"mpir=MPIR" \
"mpfr=MPFR" \

View File

@ -235,10 +235,11 @@ ALIASES = "cgal=%CGAL" \
"stl=STL" \
"gmp=GMP" \
"gmpxx=GMPXX" \
"exacus=Exacus" \
"iso=ISO" \
"lisp=Lisp" \
"ieee=IEEE" \
"ascii=ASCII" \
"exacus=Exacus" \
"mpir=MPIR" \
"mpfr=MPFR" \
"leda=LEDA" \

View File

@ -257,10 +257,11 @@ ALIASES = "cgal=%CGAL" \
"stl=STL" \
"gmp=GMP" \
"gmpxx=GMPXX" \
"exacus=Exacus" \
"iso=ISO" \
"lisp=Lisp" \
"ieee=IEEE" \
"ascii=ASCII" \
"exacus=Exacus" \
"mpir=MPIR" \
"mpfr=MPFR" \
"leda=LEDA" \

View File

@ -161,7 +161,7 @@ def protect_accentuated_letters(authors):
try:
res.encode('ascii')
except UnicodeEncodeError:
stderr.write("WARNING: a non ascii character has been found in author string for bibtex (probably a non-handled accentuated letter)."
stderr.write("WARNING: a non-ASCII character has been found in author string for bibtex (probably a non-handled accentuated letter)."
"Check the new package added and update the function protect_accentuated_letters in Documentation/scripts/generate_how_to_cite.py\n\n")
return res

View File

@ -152,33 +152,33 @@ public:
/*!
Inserts `i` into the stream. Puts whitespace around if the
stream is in ascii mode.
stream is in \ascii mode.
*/
Geomview_stream& operator<<(int i);
/*!
Inserts `i` into the stream. Puts whitespace around if the
stream is in ascii mode.
stream is in \ascii mode.
*/
Geomview_stream& operator<<(unsigned int i);
/*!
Inserts `i` into the stream. Puts whitespace around if the
stream is in ascii mode. Currently implemented by converting to int, so it
stream is in \ascii mode. Currently implemented by converting to int, so it
can be truncated on 64 bit platforms.
*/
Geomview_stream& operator<<(long i);
/*!
Inserts `i` into the stream. Puts whitespace around if the
stream is in ascii mode. Currently implemented by converting to unsigned int,
stream is in \ascii mode. Currently implemented by converting to unsigned int,
so it can be truncated on 64 bit platforms.
*/
Geomview_stream& operator<<(unsigned long i);
/*!
Inserts double `d` into the stream. Puts whitespace around if the
stream is in ascii mode.
stream is in \ascii mode.
*/
Geomview_stream& operator<<(double d);
@ -196,7 +196,7 @@ public:
/*!
Sets raw mode. In raw mode, kernel points are output without headers and
footers, just the coordinates (in binary or ascii mode). This allows the
footers, just the coordinates (in binary or \ascii mode). This allows the
implementation of the stream functions for other objects to re-use the
code for points internally, by temporary saving the raw mode to true, and
restoring it after.
@ -227,7 +227,7 @@ public:
bool set_binary_mode(bool b = true);
/*!
Sets whether we are in ascii mode.
Sets whether we are in \ascii mode.
*/
bool set_ascii_mode(bool b = true);
@ -237,7 +237,7 @@ public:
bool get_binary_mode();
/*!
Returns `true` iff `gs` is in ascii mode.
Returns `true` iff `gs` is in \ascii mode.
*/
bool get_ascii_mode();

View File

@ -35,7 +35,7 @@ operator>>(std::istream &is, MyPointC2 &p)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is) {

View File

@ -276,7 +276,7 @@ extract(std::istream& is, Circle_2<R>& c)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -233,7 +233,7 @@ extract(std::istream& is, Direction_2<R>& d, const Cartesian_tag&)
break;
default:
is.setstate(std::ios::failbit);
std::cerr << std::endl << "Stream must be in ascii or binary mode"
std::cerr << std::endl << "Stream must be in ASCII or binary mode"
<< std::endl;
break;
}
@ -259,7 +259,7 @@ extract(std::istream& is, Direction_2<R>& d, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
d = Direction_2<R>(x, y);

View File

@ -192,7 +192,7 @@ extract(std::istream& is, Direction_3<R>& d, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -218,7 +218,7 @@ extract(std::istream& is, Direction_3<R>& d, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -279,7 +279,7 @@ extract(std::istream& is, Line_2<R>& l)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -262,7 +262,7 @@ operator>>(std::istream &is, Plane_3<R> &p)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -246,7 +246,7 @@ extract(std::istream& is, Point_2<R>& p, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -273,7 +273,7 @@ extract(std::istream& is, Point_2<R>& p, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -277,7 +277,7 @@ extract(std::istream& is, Point_3<R>& p, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -305,7 +305,7 @@ extract(std::istream& is, Point_3<R>& p, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -295,7 +295,7 @@ extract(std::istream& is, Sphere_3<R>& c, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -323,7 +323,7 @@ extract(std::istream& is, Sphere_3<R>& c, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -347,7 +347,7 @@ extract(std::istream& is, Vector_2<R>& v, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -374,7 +374,7 @@ extract(std::istream& is, Vector_2<R>& v, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
v = Vector_2<R>(hx, hy, hw);

View File

@ -328,7 +328,7 @@ extract(std::istream& is, Vector_3<R>& v, const Cartesian_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -355,7 +355,7 @@ extract(std::istream& is, Vector_3<R>& v, const Homogeneous_tag&)
default:
is.setstate(std::ios::failbit);
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -294,7 +294,7 @@ extract(std::istream& is, Weighted_point_2<R>& p, const Cartesian_tag&)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -322,7 +322,7 @@ extract(std::istream& is, Weighted_point_2<R>& p, const Homogeneous_tag&)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -315,7 +315,7 @@ extract(std::istream& is, Weighted_point_3<R>& p, const Cartesian_tag&)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)
@ -344,7 +344,7 @@ extract(std::istream& is, Weighted_point_3<R>& p, const Homogeneous_tag&)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}
if (is)

View File

@ -804,7 +804,7 @@ std::istream& operator>>(std::istream& is, Matrix_<NT_,AL_>& M)
is >> M(i/rdim,i%cdim);
break;
default:
std::cerr<<"\nStream must be in ascii or binary mode"<<std::endl;
std::cerr<<"\nStream must be in ASCII or binary mode"<<std::endl;
break;
}
return is;

View File

@ -67,7 +67,7 @@ void read(std::istream& is)
case CGAL::IO::BINARY :
CGAL::read(is, _p[0]); CGAL::read(is, _p[1]); break;
default:
CGAL_error_msg("\nStream must be in ascii or binary mode\n");
CGAL_error_msg("\nStream must be in ASCII or binary mode\n");
}
}

View File

@ -244,7 +244,7 @@ void Tuple_d<NT,LA>::read(std::istream& is)
CGAL::read(is, d); v = Vector(d);
while (i < d) { CGAL::read(is, v[i]); ++i; } break;
default:
CGAL_error_msg("\nStream must be in ascii or binary mode\n");
CGAL_error_msg("\nStream must be in ASCII or binary mode\n");
}
}

View File

@ -444,7 +444,7 @@ std::istream& operator>>(std::istream& is, Vector_<NT_,AL_>& v)
}
break;
default:
std::cerr<<"\nStream must be in ascii or binary mode"<<std::endl;
std::cerr<<"\nStream must be in ASCII or binary mode"<<std::endl;
break;
}
return is;

View File

@ -11,7 +11,7 @@ namespace IO {
//! \param os the stream used for writing.
//! \param tr the triangulated domain to be written.
//! \param mode decides if the data should be written in binary (`BINARY`)
//! or in ASCII (`ASCII`).
//! or in \ascii (`ASCII`).
//!
template <class CDT>
void write_VTU(std::ostream& os,

View File

@ -408,7 +408,7 @@ int loadNoboite(char *name) {
fread(&no,sizeof(int),1,in);
}
/* read ascii file */
/* read ASCII file */
else {
fscanf(in,"%d %d %d %d %d",&ne,&np,&npfixe,&icube,&npbli);
fscanf(in,"%d %d %d %d",&nbele,&loele,&nbelef,&loelef);

View File

@ -164,7 +164,7 @@ std::istream& operator>>(std::istream& is, SPolynomial<RT>& p)
case CGAL::IO::BINARY :
CGAL::read(is,m);CGAL::read(is,n);break;
default:
CGAL_error_msg("\nStream must be in ascii or binary mode\n");
CGAL_error_msg("\nStream must be in ASCII or binary mode\n");
break;
}
return is;
@ -333,7 +333,7 @@ std::istream& operator>>(std::istream& is, Extended_point<RT>& p)
case CGAL::IO::BINARY :
CGAL::read(is,x);CGAL::read(is,y);CGAL::read(is,w); break;
default:
CGAL_error_msg("\nStream must be in ascii or binary mode\n");
CGAL_error_msg("\nStream must be in ASCII or binary mode\n");
break;
}
p = Extended_point<RT>(x,y,w);

View File

@ -32,8 +32,8 @@ using a proprietary file format. It includes the complete incidence
structure, the geometric data, and the marks of each item.
Using \cgal stream modifiers the following output formats can be
chosen: ASCII (`set_ascii_mode()`), binary (`set_binary_mode()`) or
pretty (`set_pretty_mode()`). The mandatory format is the ASCII
chosen: \ascii (`set_ascii_mode()`), binary (`set_binary_mode()`) or
pretty (`set_pretty_mode()`). The mandatory format is the \ascii
format. It is recommended to use this format for file input and
output.

View File

@ -53,7 +53,7 @@ The output of the reconstruction can be obtained in two ways: either as a sequen
\cgalExample{Optimal_transportation_reconstruction_2/otr2_indexed_output_example.cpp}
\subsection Optimal_transportation_reconstruction_2Mass_example Example with Mass Attributes
The following example first reads a set of input points and masses from an ASCII file. Using two property maps, the points and their initial mass are passed to the Optimal_transportation_reconstruction_2 object. After initialization 100 iterations of the reconstruction process are performed, then the segments and isolated points of the reconstructed shape are extracted and printed to the console.
The following example first reads a set of input points and masses from an \ascii file. Using two property maps, the points and their initial mass are passed to the Optimal_transportation_reconstruction_2 object. After initialization 100 iterations of the reconstruction process are performed, then the segments and isolated points of the reconstructed shape are extracted and printed to the console.
\cgalExample{Optimal_transportation_reconstruction_2/otr2_mass_example.cpp}

View File

@ -488,7 +488,7 @@ template <class T>
void test_io(T &pt1, bool ex)
{
std::cout << "I/O" << std::endl;
std::cout << " ascii" << std::endl;
std::cout << " ASCII" << std::endl;
std::stringstream ss1;
ss1 << pt1;

View File

@ -636,7 +636,7 @@ _test_cls_periodic_3_triangulation_3(const PeriodicTriangulation &,
if(test_input_ouput)
{
std::cout << "I/O" << std::endl;
std::cout << " ascii" << std::endl;
std::cout << " ASCII" << std::endl;
std::stringstream ss1;
std::stringstream ss3;

View File

@ -113,11 +113,11 @@ namespace IO {
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` writing: the `OFF` and `XYZ` formats
are always ASCII, and the `LAS` format is always binary.}
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalNamedParamsEnd
@ -207,11 +207,11 @@ namespace IO {
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` writing: the `OFF` and `XYZ` formats
are always ASCII, and the `LAS` format is always binary.}
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalParamNBegin{stream_precision}

View File

@ -221,7 +221,7 @@ public:
/*!
\ingroup PkgPointSet3IOPLY
\brief reads a point set with properties from an input stream in ASCII or Binary \ref IOStreamPLY.
\brief reads a point set with properties from an input stream in \ascii or binary \ref IOStreamPLY.
- the operator reads the vertex `point` property;
- if three PLY properties `nx`, `ny` and `nz` with type `float`
@ -307,7 +307,7 @@ bool read_PLY(std::istream& is, CGAL::Point_set_3<Point, Vector>& point_set)
/*!
\ingroup PkgPointSet3IOPLY
\brief reads a point set with properties from an input stream in ASCII or Binary \ref IOStreamPLY.
\brief reads a point set with properties from an input stream in \ascii or binary \ref IOStreamPLY.
- the operator reads the vertex `point` property;
- if three PLY properties `nx`, `ny` and `nz` with type `float`
@ -331,7 +331,7 @@ bool read_PLY(std::istream& is, CGAL::Point_set_3<Point, Vector>& point_set)
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -394,7 +394,7 @@ bool read_PLY(const std::string& fname, CGAL::Point_set_3<Point, Vector>& point_
\deprecated This function is deprecated since \cgal 5.3,
\link PkgPointSet3IO `CGAL::IO::read_PLY()` \endlink should be used instead.
\brief reads a point set with properties from an input stream in ASCII or Binary PLY format.
\brief reads a point set with properties from an input stream in \ascii or binary PLY format.
- the operator reads the vertex `point` property;
- if three PLY properties `nx`, `ny` and `nz` with type `float`
@ -459,7 +459,7 @@ namespace IO {
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{the precision of the stream `os`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd
@ -725,7 +725,7 @@ bool write_PLY(std::ostream& os, const CGAL::Point_set_3<Point, Vector>& point_s
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -734,7 +734,7 @@ bool write_PLY(std::ostream& os, const CGAL::Point_set_3<Point, Vector>& point_s
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -150,7 +150,7 @@ the detailed API of the Point Set Processing functions.
\cgal provides functions to read and write sets of points (possibly with normals)
from the following file formats:
- \link IOStreamXYZ XYZ \endlink (ASCII file three point coordinates `x y z` per line or three
- \link IOStreamXYZ XYZ \endlink (\ascii file three point coordinates `x y z` per line or three
point coordinates and three normal vector coordinates `x y z nx ny nz`
per line)
- \link IOStreamOFF OFF (%Object File Format) \endlink -- \cgalCite{cgal:p-gmgv16-96}
@ -161,7 +161,7 @@ not handle normals and requires the \ref thirdpartyLASlib library.
All of the functions in \ref PkgPointSetProcessing3IO (with the exception of the LAS format)
can read and write either points alone or points with normals (depending on
whether the `normal_map` named parameter is used by the user or not).
Note that the %PLY format handles both ASCII and binary formats. In
Note that the %PLY format handles both \ascii and binary formats. In
addition, %PLY and %LAS are extensible formats that can embed additional
properties. These can also be read by \cgal (see Section \ref
Point_set_processing_3Properties_io).

View File

@ -296,7 +296,7 @@ bool read_PLY(std::istream& is,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd

View File

@ -73,11 +73,11 @@ namespace IO {
\cgalParamNEnd
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` reading: the `OFF` and `XYZ` formats
are always ASCII, and the `LAS` format is always binary.}
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -178,7 +178,7 @@ template <typename PointRange,
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{the precision of the stream `os`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd
@ -250,7 +250,7 @@ bool write_PLY(std::ostream& os, const PointRange& points,
\cgalNamedParamsBegin
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamNEnd
@ -277,7 +277,7 @@ bool write_PLY(std::ostream& os, const PointRange& points,
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -76,18 +76,18 @@ namespace IO {
\cgalParamNEnd
\cgalParamNBegin{use_binary_mode}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
\cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
\cgalParamType{Boolean}
\cgalParamDefault{`true`}
\cgalParamExtra{This parameter is only relevant for `PLY` writing: the `OFF` and `XYZ` formats
are always ASCII, and the `LAS` format is always binary.}
are always \ascii, and the `LAS` format is always binary.}
\cgalParamNEnd
\cgalParamNBegin{stream_precision}
\cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
\cgalParamType{int}
\cgalParamDefault{`6`}
\cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
\cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
\cgalParamNEnd
\cgalNamedParamsEnd

View File

@ -164,12 +164,11 @@ protected:
/*!
This operator exports a General_polygon_with_holes_2 to the output stream `out`.
An ASCII and a binary format exist. The format can be selected with
An \ascii and a binary format exist. The format can be selected with
the \cgal modifiers for streams, `set_ascii_mode(0` and `set_binary_mode()`
respectively. The modifier `set_pretty_mode()` can be used to allow for (a
few) structuring comments in the output. Otherwise, the output would
be free of comments. The default for writing is ASCII without
comments.
be free of comments. The default for writing is \ascii without comments.
The number of curves of the outer boundary is exported followed by the
curves themselves. Then, the number of holes

View File

@ -82,12 +82,11 @@ public:
/*!
This operator exports a polygon with holes to the output stream `out`.
An ASCII and a binary format exist. The format can be selected with
An \ascii and a binary format exist. The format can be selected with
the \cgal modifiers for streams, `set_ascii_mode()` and `set_binary_mode()`
respectively. The modifier `set_pretty_mode()` can be used to allow for (a
few) structuring comments in the output. Otherwise, the output would
be free of comments. The default for writing is ASCII without
comments.
be free of comments. The default for writing is \ascii without comments.
The number of points of the outer boundary is exported followed by the
points themselves in counterclockwise order. Then, the number of holes

View File

@ -56,15 +56,15 @@ std::istream& operator>>( std::istream& in, Polyhedron_3<Traits>& P);
writes the polyhedral surface \f$P\f$ to the output
stream `out` using the %Object File Format, OFF, with file extension
<TT>.off</TT>. The output is in ASCII format. From the polyhedral surface, only the point
<TT>.off</TT>. The output is in \ascii format. From the polyhedral surface, only the point
coordinates and facets are written. Neither normal vectors nor color
attributes are used.
For OFF an ASCII and a binary format exist. The format can be selected
For `OFF` an \ascii and a binary format exist. The format can be selected
with the \cgal modifiers for streams, `set_ascii_mode()` and
`set_binary_mode()` respectively. The modifier `set_pretty_mode()` can be used
to allow for (a few) structuring comments in the output. Otherwise,
the output would be free of comments. The default for writing is ASCII
the output would be free of comments. The default for writing is \ascii
without comments.
This function overloads the generic function \link PkgBGLIoFuncsOFF `write_OFF(std::istream&,FaceGraph)` \endlink

View File

@ -12,7 +12,7 @@ typedef CGAL::Simple_cartesian<double>::Point_3 Point_3;
int main(int argc, char* argv[])
{
#if 0
std::cerr << "ascii to binary\n";
std::cerr << "ASCII to binary\n";
int d;
int N;
Point_3 p;

View File

@ -109,7 +109,7 @@ returns the saturation ratio.
FT get_saturation_ratio() const;
/*!
prints the streamlines to an ASCII file: line by line, and point by point.
prints the streamlines to an \ascii file: line by line, and point by point.
*/
void print_stream_lines(std::ofstream & fw);

View File

@ -18,7 +18,7 @@ int main()
{
Runge_kutta_integrator runge_kutta_integrator(1);
/*datap.tri.cin and datav.tri.cin are ascii files where are stored the vector values*/
/*datap.tri.cin and datav.tri.cin are ASCII files where are stored the vector values*/
std::ifstream inp("data/datap.tri.cin");
std::ifstream inv("data/datav.tri.cin");
std::istream_iterator<Point> beginp(inp);

View File

@ -31,7 +31,7 @@ users to provide more properties such as associating normals or colors to vertic
A precise specification of the format is available at <a href="http://www.geomview.org/docs/html/OFF.html">geomview.org</a>.
Note that the format defines both ASCII and binary OFF formats, but only the ASCII OFF format is supported in \cgal.
Note that the format defines both \ascii and binary OFF formats, but only the \ascii OFF format is supported in \cgal.
The following table lists some \cgal data structures that have I/O functions compatible with this file format.
@ -104,7 +104,7 @@ which offers combinatorial repairing while reading bad inputs.
\section IOStreamOBJ Wavefront Advanced Visualizer Object Format (OBJ)
The `OBJ` file format, using the file extension `.obj`, is a simple ASCII data format that represents 3D geometry.
The `OBJ` file format, using the file extension `.obj`, is a simple \ascii data format that represents 3D geometry.
Vertices are stored in a counter-clockwise order by default, making explicit declaration of face normals unnecessary.
A precise specification of the format is available <a href="http://www.martinreddy.net/gfx/3d/OBJ.spec">here</a>.
@ -144,7 +144,7 @@ which offers combinatorial repairing while reading bad inputs.
\section IOStreamSTL STereoLithography (STL) File Format
The `STL` file format, using the file extension `.stl`, is an ASCII or binary format native
The `STL` file format, using the file extension `.stl`, is an \ascii or binary format native
to the stereolithography CAD software created by 3D Systems.
STL files describe the surface geometry of a three-dimensional object.
@ -188,7 +188,7 @@ which offers combinatorial repairing while reading bad inputs.
\section IOStreamPLY Polygon File Format (PLY)
The `PLY` file format, using the file extension `.ply`, is an ASCII or binary format
The `PLY` file format, using the file extension `.ply`, is an \ascii or binary format
conceived to store the data obtained during 3D scans. Objects are stored
as a simple list of polygons and external properties can be stored.
@ -291,7 +291,7 @@ A precise specification of those formats is available
\section IOStreamXYZ XYZ File Format
The `XYZ` format, using the file extension `.xyz`, is a non-standard ASCII data format
The `XYZ` format, using the file extension `.xyz`, is a non-standard \ascii data format
regularly used to describe point sets. Each line represent a point, and is composed
of its coordinates and other properties. Only coordinates and normals are currently supported in \cgal.
@ -324,7 +324,7 @@ of its coordinates and other properties. Only coordinates and normals are curren
\section IOStreamGocad GOCAD (TS) File Format
The `GOCAD` format, using the file extension `.ts`, is an ASCII file format
The `GOCAD` format, using the file extension `.ts`, is an \ascii file format
that enables a range of primitive types to be imported into the GOCAD package.
A precise specification of the format is available <a href="http://paulbourke.net/dataformats/gocad/gocad.pdf"> here</a>.
@ -408,7 +408,7 @@ which offers combinatorial repairing while reading bad inputs.
\section IOStreamWRL Virtual Reality Modeling Language (VRML) File Format
The `VRML` format, using the file extension `.wrl`, is an ASCII format often used by browser plug-ins
The `VRML` format, using the file extension `.wrl`, is an \ascii format often used by browser plug-ins
to display virtual reality environments. VRML files are known as “worlds,” which is what "WRL" stands for.
A WRL file includes data specifying 3-D details such as vertices, edges for a 3-D polygon, surface color, ...

View File

@ -53,14 +53,14 @@ I/O streams. Classes external to \cgal are also supported, by means of `oformat(
(Section \ref seciofornoncgaltypes "I/O for Non CGAL Types").
The basic task of such an operator is to produce a
representation of an object that can be written as a sequence of
characters on devices as a console, a file, or a pipe. In \cgal we distinguish between a raw ascii,
characters on devices as a console, a file, or a pipe. In \cgal we distinguish between a raw \ascii,
a raw binary, and a pretty printing format.
\code{.cpp}
enum Mode {ASCII = 0, BINARY, PRETTY};
\endcode
In `ASCII` mode, objects are written as
In \ascii mode, objects are written as
a set of numbers, e.g. the coordinates of a point or
the coefficients of a line, in a machine independent format.
In `BINARY` mode,
@ -72,7 +72,7 @@ object is written, as well as the data defining the object. For example
for a point at the origin with Cartesian double coordinates, the output
would be `PointC2(0.0, 0.0)`. At the moment \cgal does not
provide input operations for pretty printed data. By default a stream
is in <span class="textsc">Ascii</span> mode.
is in \ascii mode.
\cgal provides the following functions to modify the mode of an I/O stream.
@ -322,7 +322,7 @@ All of these functions (with the exception of the LAS format) can read
and write either points alone or points with normals (depending on
whether the `normal_map` named parameter is used by the user or not).
Note that the %PLY format handles both ASCII and binary formats. In
Note that the %PLY format handles both \ascii and binary formats. In
addition, %PLY and %LAS are extensible formats that can embed additional
properties. These can also be read by \cgal (see Section \ref
Point_set_processing_3Properties_io).

View File

@ -45,7 +45,7 @@
\cgalPkgPicture{io.png}
\cgalPkgSummaryBegin
\cgalPkgAuthors{Andreas Fabri, Geert-Jan Giezeman, and Lutz Kettner}
\cgalPkgDesc{All classes in the \cgal kernel provide input and output operators for I/O streams. The basic task of such an operator is to produce a representation of an object that can be written as a sequence of characters on devices as a console, a file, or a pipe. In \cgal we distinguish between a raw ascii, a raw binary and a pretty printing format.}
\cgalPkgDesc{All classes in the \cgal kernel provide input and output operators for I/O streams. The basic task of such an operator is to produce a representation of an object that can be written as a sequence of characters on devices as a console, a file, or a pipe. In \cgal we distinguish between a raw \ascii, a raw binary and a pretty printing format.}
\cgalPkgManuals{Chapter_IO_Streams,PkgStreamSupportRef}
\cgalPkgSummaryEnd
\cgalPkgShortInfoBegin

View File

@ -294,7 +294,7 @@ bool read_PLY(std::istream& is,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -365,7 +365,7 @@ bool read_PLY(std::istream& is, PointRange& points, PolygonRange& polygons,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -445,7 +445,7 @@ bool read_PLY(const std::string& fname, PointRange& points, PolygonRange& polygo
* \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
* \cgalParamType{int}
* \cgalParamDefault{the precision of the stream `os`}
* \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
* \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
* \cgalParamNEnd
* \cgalNamedParamsEnd
*
@ -526,7 +526,7 @@ bool write_PLY(std::ostream& out, const PointRange& points, const PolygonRange&
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -535,7 +535,7 @@ bool write_PLY(std::ostream& out, const PointRange& points, const PolygonRange&
* \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
* \cgalParamType{int}
* \cgalParamDefault{`6`}
* \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
* \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
* \cgalParamNEnd
* \cgalNamedParamsEnd
*

View File

@ -188,7 +188,7 @@ bool read_STL(std::istream& is, PointRange& points, TriangleRange& facets,
*
* \brief reads the content of a file named `fname` into `points` and `facets`, using the \ref IOStreamSTL.
*
* If `use_binary_mode` is `true`, but the reading fails, ASCII reading will be automatically tested.
* If `use_binary_mode` is `true`, but the reading fails, \ascii reading will be automatically tested.
* \attention The polygon soup is not cleared, and the data from the file are appended.
*
* \tparam PointRange a model of the concept `RandomAccessContainer` whose value type is the point type.
@ -204,7 +204,7 @@ bool read_STL(std::istream& is, PointRange& points, TriangleRange& facets,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be read in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -287,7 +287,7 @@ bool read_STL(const std::string& fname, PointRange& points, TriangleRange& facet
* \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
* \cgalParamType{int}
* \cgalParamDefault{the precision of the stream `os`}
* \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
* \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
* \cgalParamNEnd
* \cgalNamedParamsEnd
*
@ -398,7 +398,7 @@ bool write_STL(std::ostream& os, const PointRange& points, const TriangleRange&
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -407,7 +407,7 @@ bool write_STL(std::ostream& os, const PointRange& points, const TriangleRange&
* \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
* \cgalParamType{int}
* \cgalParamDefault{`6`}
* \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
* \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
* \cgalParamNEnd
* \cgalNamedParamsEnd
*

View File

@ -363,7 +363,7 @@ void write_soup_polys_points(std::ostream& os,
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd
@ -461,7 +461,7 @@ bool write_VTP(std::ostream& os, const PointRange& points, const PolygonRange& p
*
* \cgalNamedParamsBegin
* \cgalParamNBegin{use_binary_mode}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in ASCII (`false`)}
* \cgalParamDescription{indicates whether data should be written in binary (`true`) or in \ascii (`false`)}
* \cgalParamType{Boolean}
* \cgalParamDefault{`true`}
* \cgalParamNEnd

View File

@ -55,7 +55,7 @@ IOStreams. The basic task of such an operator is to produce a
representation of an object that can be written as a sequence of
characters on devices as a console, a file, or a pipe. The enum `Mode` distinguish between three different printing formats.
In `ASCII` mode, numbers
In \ascii mode, numbers
e.g. the coordinates of a point or
the coefficients of a line, are written
in a machine independent format.
@ -68,7 +68,7 @@ object is written, as well as the data defining the object. For example
for a point at the origin with %Cartesian double coordinates, the output
would be `PointC2(0.0, 0.0)`. At the moment \cgal does not
provide input operations for pretty printed data. By default a stream
is in <span class="textsc">Ascii</span> mode.
is in \ascii mode.
\sa `CGAL::IO::set_mode()`
\sa `CGAL::IO::set_ascii_mode()`
@ -458,7 +458,7 @@ inline Mode get_mode(std::ios& s)
/*!
\ingroup PkgStreamSupportRef
sets the mode of the %IO stream `s` to be the `ASCII` mode.
sets the mode of the %IO stream `s` to be the \ascii mode.
Returns the previous mode of `s`.
\link PkgStreamSupportEnumRef `CGAL::IO::Mode`\endlink
@ -561,7 +561,7 @@ inline bool is_pretty(std::ios& s) { return s.iword(Static::get_mode()) == PRETT
/*!
\ingroup PkgStreamSupportRef
checks if the %IO stream `s` is in `ASCII` mode.
checks if the %IO stream `s` is in \ascii mode.
\link PkgStreamSupportEnumRef `CGAL::IO::Mode`\endlink
\sa `CGAL::IO::set_mode()`
@ -684,7 +684,7 @@ inline std::istream &operator>>(std::istream &is, Color& col)
break;
default:
std::cerr << "" << std::endl;
std::cerr << "Stream must be in ascii or binary mode" << std::endl;
std::cerr << "Stream must be in ASCII or binary mode" << std::endl;
break;
}

View File

@ -903,7 +903,7 @@ namespace IO {
/// \cgalParamDescription{a parameter used to set the precision (i.e. how many digits are generated) of the output stream}
/// \cgalParamType{int}
/// \cgalParamDefault{the precision of the stream `os`}
/// \cgalParamExtra{This parameter is only meaningful while using ASCII encoding.}
/// \cgalParamExtra{This parameter is only meaningful while using \ascii encoding.}
/// \cgalParamNEnd
/// \cgalNamedParamsEnd
///