From sjh13@cwru.edu Mon Jul 28 16:05:13 2003
Return-Path:
@@ -2620,7 +2620,7 @@ this section.
--- sgml-primer/chapter.sgml.orig Mon Jul 28 17:45:25 2003 +++ sgml-primer/chapter.sgml Mon Jul 28 17:18:28 2003 @@ -53,7 +53,7 @@Inevitably, this was not enough. Once you have text in a machine-usable format, you expect machines to be able to use it and manipulate it intelligently. You would like to indicate that certain - phrases should be emphasised, or added to a glossary, or be hyperlinks. + phrases should be emphasized, or added to a glossary, or be hyperlinks. You might want filenames to be shown in a @@ -90,7 +90,7 @@typewriterstyle font for viewing on screen, but asitalicswhen printed, or any of a myriad of other options for presentation.The extra information stored in the markup @@ -199,7 +199,7 @@adds value to the document. Adding the markup to the document must typically be done by a person—after all, if computers could - recognise the text sufficiently well to add the markup then there would + recognize the text sufficiently well to add the markup then there would be no need to add it in the first place. Thisincreases the cost (i.e., the effort required) to create the document.A tag is used to identify where a particular element starts, and where the element ends. The tag is not part of the element itself . Because each DTD was normally written to mark up - specific types of information, each one will recognise different + specific types of information, each one will recognize different elements, and will therefore have different names for the tags.For an element called element-name the @@ -251,7 +251,7 @@Elements within elements; em This is a simple paragraph where some - of the words have been emphasised.]]> + of the words have been emphasized.]]>The DTD will specify the rules detailing which elements can contain @@ -643,7 +643,7 @@ -ISO 9070:1991 defines how registered names are generated; it might be derived from the number of an ISO publication, an ISBN - code, or an organisation code assigned according to ISO 6523. + code, or an organization code assigned according to ISO 6523. In addition, a registration authority could be created in order to assign registered names. The ISO council delegated this to the American National Standards Institute (ANSI). @@ -796,7 +796,7 @@ your document. Everything between these delimiters is SGML syntax as you might find within a DTD.As you may just have realised, the As you may just have realized, the DOCTYPE declaration is an example of SGML syntax that you need to include in your document… @@ -1051,7 +1051,7 @@Load + before your browser recognizes it as an HTML document).example.sgml into your web browser (you may need to copy it toexample.html - before your browser recognises it as an HTML document).Unless your browser is very advanced, you will not see the entity reference &version; replaced with the @@ -1064,10 +1064,10 @@- The solution is to normalise your - document using an SGML normaliser. The normaliser reads in valid +The solution is to @@ -1075,7 +1075,7 @@normalize your + document using an SGML normalizer. The normalizer reads in valid SGML and outputs equally valid SGML which has been transformed in - some way. One of the ways in which the normaliser transforms the + some way. One of the ways in which the normalizer transforms the SGML is to expand all the entity references in the document, replacing the entities with the text that they represent.&prompt.user; -sgmlnorm example.sgml > example.html You should find a normalised (i.e., entity references + You should find a normalized (i.e., entity references expanded) copy of your document in @@ -1156,7 +1156,7 @@ entities.example.html , ready to load into your web browser.Suppose that you had many chapters in your document, and you - reused these chapters in two different books, each book organising the + reused these chapters in two different books, each book organizing the chapters in a different fashion. You could list the entities at the top of each book, but this @@ -1242,7 +1242,7 @@ - Produce example.html by normalising +Produce example.html by normalizingexample.sgml .&prompt.user; @@ -1299,7 +1299,7 @@sgmlnorm -d example.sgml > example.html - Produce -example.html by normalising +Produce example.html by normalizingexample.sgml .&prompt.user; @@ -1455,7 +1455,7 @@ from your document you could cut it out, or wrap it in comments.sgmlnorm -d example.sgml > example.html It becomes more useful when you realise you can use It becomes more useful when you realize you can use parameter entities to control this. Remember that parameter entities can only be used in SGML contexts, and the keyword of a marked section @@ -1542,7 +1542,7 @@ - Normalise this file using &man.sgmlnorm.1; and examine the + --- structure/chapter.sgml.orig Mon Jul 28 17:46:09 2003 +++ structure/chapter.sgml Mon Jul 28 17:20:35 2003 @@ -45,7 +45,7 @@Normalize this file using &man.sgmlnorm.1; and examine the output. Notice which paragraphs have appeared, which have disappeared, and what has happened to the content of the CDATA marked section. @@ -1551,7 +1551,7 @@@@ -1564,7 +1564,7 @@ Change the definition of the text.output entity fromINCLUDE to -IGNORE . Re-normalise the file, and examine the +IGNORE . Re-normalize the file, and examine the output to see what has changed.That is the conclusion of this SGML primer. For reasons of space and complexity several things have not been covered in depth (or at all). However, the previous sections cover enough SGML for you to be - able to follow the organisation of the FDP documentation. + able to follow the organization of the FDP documentation.@@ -76,7 +76,7 @@ promote consistency between the different documentation - organisations, to make it easier to switch between working on + organizations, to make it easier to switch between working on different documents Contains files that are not specific to the various translations and encodings of the documentation. Contains subdirectories to - further categorise the information. For example, the files that + further categorize the information. For example, the files that comprise the &man.make.1; infrastructure are in share/mk , while the additional SGML support files (such as the FreeBSD extended DocBook DTD) are in --- stylesheets/chapter.sgml.orig Mon Jul 28 17:47:05 2003 +++ stylesheets/chapter.sgml Mon Jul 28 17:19:38 2003 @@ -44,7 +44,7 @@* DSSSL -The Documentation Project uses a slightly customised version of + The Documentation Project uses a slightly customized version of Norm Walsh's modular DocBook stylesheets. These can be found in @@ -55,7 +55,7 @@ found in --- translations/chapter.sgml.orig Mon Jul 28 17:48:35 2003 +++ translations/chapter.sgml Mon Jul 28 17:22:44 2003 @@ -66,8 +66,8 @@doc/share/sgml/freebsd.dsl . It is well commented, and pending completion of this section you are encouraged to examine that file to see how some of the available options in the - standard stylesheets have been configured in order to customise the + standard stylesheets have been configured in order to customize the output for the FreeBSD Documentation Project. That file also contains examples showing how to extend the elements that the stylesheet understands, which is how the FreeBSD specific elements have been --- tools/chapter.sgml.orig Mon Jul 28 17:48:00 2003 +++ tools/chapter.sgml Mon Jul 28 17:14:40 2003 @@ -95,7 +95,7 @@A suite of applications, including a validating SGML parser, - and an SGML normaliser. + and an SGML normalizer.i18n means -internationalisation andl10n - meanslocalisation . They are just a convenient +internationalization andl10n + meanslocalization . They are just a convenient shorthand.i18n can be read asifollowed by @@ -196,7 +196,7 @@First, decide whether or not you have got the time to spare. Since you are the only person working on your language at the moment it is - going to be your responsibility to publicise your work and + going to be your responsibility to publicize your work and coordinate any volunteers that might want to help you. Write an e-mail to the Documentation Project mailing list, >Release-Note: >Audit-Trail: State-Changed-From-To: open->closed State-Changed-By: murray State-Changed-When: Mon Aug 2 06:01:25 GMT 2004 State-Changed-Why: Committed. Thanks for the submission. It may take up to 24 hours for your change to be visible on our website. http://www.freebsd.org/cgi/query-pr.cgi?pr=54999 >Unformatted: