From mboxrd@z Thu Jan 1 00:00:00 1970 X-Msuck: nntp://news.gmane.io/gmane.comp.tex.context/84374 Path: news.gmane.org!not-for-mail From: Marco Patzer Newsgroups: gmane.comp.tex.context Subject: Re: ConTeXt Manual Errata Date: Sat, 21 Sep 2013 19:15:01 +0200 Message-ID: <20130921171501.GG17308@homerow> References: Reply-To: mailing list for ConTeXt users NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0471186593==" X-Trace: ger.gmane.org 1379783716 27049 80.91.229.3 (21 Sep 2013 17:15:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 21 Sep 2013 17:15:16 +0000 (UTC) To: ntg-context@ntg.nl Original-X-From: ntg-context-bounces@ntg.nl Sat Sep 21 19:15:20 2013 Return-path: Envelope-to: gctc-ntg-context-518@m.gmane.org Original-Received: from balder.ntg.nl ([5.39.185.229]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VNQm8-0001Zq-78 for gctc-ntg-context-518@m.gmane.org; Sat, 21 Sep 2013 19:15:20 +0200 Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id C8971101F1; Sat, 21 Sep 2013 19:13:18 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id gqhiAiuXKj2Q; Sat, 21 Sep 2013 19:13:15 +0200 (CEST) Original-Received: from balder.ntg.nl (localhost [IPv6:::1]) by balder.ntg.nl (Postfix) with ESMTP id 7F656101E5; Sat, 21 Sep 2013 19:13:15 +0200 (CEST) Original-Received: from localhost (localhost [127.0.0.1]) by balder.ntg.nl (Postfix) with ESMTP id A9831101E5 for ; Sat, 21 Sep 2013 19:13:13 +0200 (CEST) X-Virus-Scanned: Debian amavisd-new at balder.ntg.nl Original-Received: from balder.ntg.nl ([127.0.0.1]) by localhost (balder.ntg.nl [127.0.0.1]) (amavisd-new, port 10024) with LMTP id MJnn9qYGagLG for ; Sat, 21 Sep 2013 19:13:12 +0200 (CEST) Original-Received: from filter1-utr.mf.surf.net (filter1-utr.mf.surf.net [195.169.124.152]) by balder.ntg.nl (Postfix) with ESMTP id 6D74410193 for ; Sat, 21 Sep 2013 19:13:11 +0200 (CEST) Original-Received: from forward2l.mail.yandex.net (forward2l.mail.yandex.net [IPv6:2a02:6b8:0:1819::2]) by filter1-utr.mf.surf.net (8.14.3/8.14.3/Debian-9.4) with ESMTP id r8LHFB8q024489 for ; Sat, 21 Sep 2013 19:15:11 +0200 Original-Received: from smtp2h.mail.yandex.net (smtp2h.mail.yandex.net [84.201.187.145]) by forward2l.mail.yandex.net (Yandex) with ESMTP id 8FB801AC0DB1 for ; Sat, 21 Sep 2013 21:15:03 +0400 (MSK) Original-Received: from smtp2h.mail.yandex.net (localhost [127.0.0.1]) by smtp2h.mail.yandex.net (Yandex) with ESMTP id 509781701EB2 for ; Sat, 21 Sep 2013 21:15:03 +0400 (MSK) Original-Received: from unknown (unknown [83.68.239.193]) by smtp2h.mail.yandex.net (nwsmtp/Yandex) with ESMTP id WkbdkGHp2q-F2jWicB9; Sat, 21 Sep 2013 21:15:02 +0400 Mail-Followup-To: ntg-context@ntg.nl In-Reply-To: X-PGP-Key: http://pgp.mit.edu:11371/pks/lookup?op=get&search=0xB8CFCB65D4F08C27 User-Agent: Mutt/1.5.21 (2010-09-15) X-Bayes-Prob: 0.0086 (Score 0, tokens from: @@RPTN) X-CanIt-Geo: ip=2a02:6b8:0:1819::2; country=RU X-CanItPRO-Stream: uu:ntg-context@ntg.nl (inherits from uu:default, base:default) X-Canit-Stats-ID: 07KrRfbK4 - 9b24006bdefe - 20130921 (trained as not-spam) X-Scanned-By: CanIt (www . roaringpenguin . com) X-BeenThere: ntg-context@ntg.nl X-Mailman-Version: 2.1.14 Precedence: list List-Id: mailing list for ConTeXt users List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: ntg-context-bounces@ntg.nl Original-Sender: ntg-context-bounces@ntg.nl Xref: news.gmane.org gmane.comp.tex.context:84374 Archived-At: --===============0471186593== Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="Izn7cH1Com+I3R9J" Content-Disposition: inline --Izn7cH1Com+I3R9J Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2013=E2=80=9309=E2=80=9318 Thangalin wrote: Hi Dave, > During a recent plane ride, I started to read the ConTeXt manual > to get a better understanding: > http://www.ctex.org/documents/context/cont-enp.pdf A more recent manual can be found at http://pmrb.free.fr/contextref.pdf > If anyone has plans to revise it, I assume everybody on this list had at some point plans to revise the manual(s). Due to lack of time this has never happened. > I have attached a file with corrections, specific comments, and > general comments. Thanks a lot for the corrections and suggestions. > I did not have the ConTeXt manual source code on hand, so I could > not directly modify it. http://wiki.contextgarden.net/Improving_the_manuals Do not count on someone else to fix it. Create an account and fix what you think could be improved, especially the grammar and spelling mistakes. If you're unsure about something, write a mail to the manual mailing list=C2=B9 for questions about the manual (style, layout, etc.) or this list for everything else. Note: The manual has not been updated since a while and it's broken at the moment. I'll prepare a fix soon, so it will compile with a recent MkIV. > Take the comments with a grain of salt: Take the existing manuals with a grain of salt ;) > ConTeXT Manual Errata & Suggestions > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D >=20 > Section 1.3. > ------------ > The word "something" needs to be defined before it is used. > For example, "\setupsomething" <- What does "something" mean? A placeholder like foobar or whatever. I think it's clear from the context, otherwise feel free to define it. > The \defineenumeration[Question] creates a \Question command, > but \definehead[Procedure][section] does not create \Procedure command? It does: \definehead [Procedure] [section] \starttext \Procedure{something} \stoptext However, I'd suggest to instead use: \startProcedure [title=3Dsomething] =E2=80=A6 \stopProcedure > The \startnarrower requires an explanation on how it affects the > resulting document. Likewise \startitemnize. Feel free to add some info from the wiki. http://wiki.contextgarden.net/Command/startnarrower http://wiki.contextgarden.net/Enumerations > What does the "of" in "\beginofAnswer" mean? Is it required? It's not required. It's actually wrong. > Where does it come from? Why is it not simply "\beginAnswer"? MkII maybe? > "Figure 1.1 is typeset this way" should include the page number. That's more difficult than it seems to be. The manual is available in different paper sizes and formats. This means the page number can't be coded as \in{figure}[foo] on \at{page}[foo], since the figure might end up on the same page. As far as I know ConTeXt does not have a general mechanism for automatically placing the =E2=80=9Con page=E2=80=A6=E2=80=9D string if the reference is not on the current page. = \atpage comes close, though. > Document processing is best done by TeXexec -- is this still true? Well, your manual is from 2000. > I thought the "context" program supercedes TeXexec? yes > Describe the relationship between TeX and ConTeXt. For example, why do the > subsequent sections discuss TeX examples? ConTeXt uses TeX and the following sections introduce some TeX concepts that hold true for ConTeXt as well. > Section 1.9. > ------------ > Relatively empty page. On purpose. The reader is invited to take a break and grab a coffee. ;) > Section 2.2. > ------------ > "It is advisable to type the document setups before the \start--command,"= -- > What start command? \starttext, perhaps? \starttext, \startdocument, \startcomponent, etc. Marco --Izn7cH1Com+I3R9J Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.14 (GNU/Linux) iQEcBAEBAgAGBQJSPdQVAAoJEPGqVaNSn0iKrIAH+gLUWP1yBkgU21RU+swi/T1b qikeK7CAk95Fmiw4r/2/4Bhkp5zPAWp9UvGaYEGzuC0qD0kNMjGkarYmm2V944dY UEagqZoOvqk2qfKDQV8lcR7IkKoLtVgdjtpqCYByp3wGkhwYhnS/tIe425RQM+h+ swvtwP3mF09tch9uxTApebZQW8AXkjEwB7HCwOBIDvuZwmDyOQbREqF5EChRoQ4z 6pADJEwOdZGKeiCumGF6plHmeovCZ/UIhlQN2wDqJ2Hup72pRf3WyBizep+csaKB 4aJt/VCHFMkh1IchI+5IuonXVxal4w/+uamhrcl2W+EMve44FVXRNpIYB7yfYww= =6NKR -----END PGP SIGNATURE----- --Izn7cH1Com+I3R9J-- --===============0471186593== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline ___________________________________________________________________________________ If your question is of interest to others as well, please add an entry to the Wiki! maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context webpage : http://www.pragma-ade.nl / http://tex.aanhet.net archive : http://foundry.supelec.fr/projects/contextrev/ wiki : http://contextgarden.net ___________________________________________________________________________________ --===============0471186593==--