Re: [PHP-DOC] cvs: phpdoc /en/reference/strings/functionsstrnatcmp.xml substr-count.xml
> > > role="php" is used for PHP color highlighting in the new > > > CHM version, and may be used for other things (eg. generating > > > an index of examples by type). So if an example contains sql > > > code, then it's quite nice to have it with role="sql". > > > role="mysql" may be too specific though... > > > > imho having a sql string show as a normal PHP string > > is fine. What would role="sql" do, make keywords > > like SELECT and INSERT bold? > > Maybe :) And would also be useful in an > "examples by type" index ;)) > > role="sql" is just classification. The non-php examples > *should not* use the role="php" attribute-value. > > Currently only the PHP examples are hilghlited, and only > in the offline new CHM version. But tagging examples with > their types may open several possibilities in the future... So to justify this a bit more, it's much more important, what it means, than how it's rendered right now... So please classify examples. We may also invent a list of example classes. Some candidates: php sql httpd ini shell http Goba
Re: [PHP-DOC] cvs: phpdoc /en/reference/strings/functionsstrnatcmp.xml substr-count.xml
> > role="php" is used for PHP color highlighting in the new > > CHM version, and may be used for other things (eg. generating > > an index of examples by type). So if an example contains sql > > code, then it's quite nice to have it with role="sql". > > role="mysql" may be too specific though... > > imho having a sql string show as a normal PHP string > is fine. What would role="sql" do, make keywords > like SELECT and INSERT bold? Maybe :) And would also be useful in an "examples by type" index ;)) role="sql" is just classification. The non-php examples *should not* use the role="php" attribute-value. Currently only the PHP examples are hilghlited, and only in the offline new CHM version. But tagging examples with their types may open several possibilities in the future... Goba
Re: [PHP-DOC] cvs: phpdoc /en/reference/strings/functionsstrnatcmp.xml substr-count.xml
> > sander Sun May 26 12:48:34 2002 EDT > > > Modified files: > > /phpdoc/en/reference/strings/functions strnatcmp.xml > > substr-count.xml > > Log: > > Fix examples > > Am I right, we only have as also mentioned > in the howto? > > In the mysql-functions there are some > > > > Are there plans about? If not, I'll correct this. role="php" is used for PHP color highlighting in the new CHM version, and may be used for other things (eg. generating an index of examples by type). So if an example contains sql code, then it's quite nice to have it with role="sql". role="mysql" may be too specific though... BTW we also have role="ini" in some places and role="httpd.conf" or something like that... Goba