Documentation

Documentation

[Alain Delmotte]

Hi!

First, sorry to have sent the previous message twice. I didn't check for 
the sending email, received a bounce, resent to discover it passed to 
the list.

I have downloaded a great part of the documentation (59 files or so).
But if I understood well, there has been big changes between Mark II and 
Mark IV/Lua.
The documentation seems more linked to MkII.

Is mk.pdf the file to use (in conjonction with another?)?

I like cont-eni.pdf but I'd like to have it as print not to be seen on 
screen (old habit of work - or habit of work of old!!)

___________________________________________________________________________________
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  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Documentation

[luigi scarso]

On Wed, Sep 16, 2009 at 4:54 PM, Alain Delmotte
<alain.delmotte@leliseron.org> wrote:
> Hi!
>
> First, sorry to have sent the previous message twice. I didn't check for the
> sending email, received a bounce, resent to discover it passed to the list.
>
> I have downloaded a great part of the documentation (59 files or so).
> But if I understood well, there has been big changes between Mark II and
> Mark IV/Lua.
> The documentation seems more linked to MkII.
>
> Is mk.pdf the file to use (in conjonction with another?)?
it's ok
>
> I like cont-eni.pdf but I'd like to have it as print not to be seen on
> screen (old habit of work - or habit of work of old!!)
there is a copy for print too.
google  http://www.pragma-ade.nl

Fore the rest

** U S E  T H E  W I K I  **,

this mailing list,

and stay in tune :)


-- 
luigi
___________________________________________________________________________________
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  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Documentation

[Hans Hagen]

Alain Delmotte wrote:

> I have downloaded a great part of the documentation (59 files or so).
> But if I understood well, there has been big changes between Mark II and 
> Mark IV/Lua.
> The documentation seems more linked to MkII.
> 
> Is mk.pdf the file to use (in conjonction with another?)?

mk is the development history of luatex / mkiv till version 0.50; it 
definitely shows some mkiv trickery but as we're mostly upward 
compatible the wiki might be a better place to start

> I like cont-eni.pdf but I'd like to have it as print not to be seen on 
> screen (old habit of work - or habit of work of old!!)

taco and i are thinking about a solution for providing printed manuals 
at some point

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
      tel: 038 477 53 69 | fax: 038 477 53 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
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  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Documentation

[Alain Delmotte]

Hans Hagen a écrit :
> Alain Delmotte wrote:
>
>> I have downloaded a great part of the documentation (59 files or so).
>> But if I understood well, there has been big changes between Mark II 
>> and Mark IV/Lua.
>> The documentation seems more linked to MkII.
>>
>> Is mk.pdf the file to use (in conjonction with another?)?
>
> mk is the development history of luatex / mkiv till version 0.50; it 
> definitely shows some mkiv trickery but as we're mostly upward 
> compatible the wiki might be a better place to start
>
>> I like cont-eni.pdf but I'd like to have it as print not to be seen 
>> on screen (old habit of work - or habit of work of old!!)
>
> taco and i are thinking about a solution for providing printed manuals 
> at some point

Thanks,

Alain
>
> Hans
>
> -----------------------------------------------------------------
>                                           Hans Hagen | PRAGMA ADE
>               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
>      tel: 038 477 53 69 | fax: 038 477 53 74 | www.pragma-ade.com
>                                              | www.pragma-pod.nl
> -----------------------------------------------------------------
> ___________________________________________________________________________________ 
>
> 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  : https://foundry.supelec.fr/projects/contextrev/
> wiki     : http://contextgarden.net
> ___________________________________________________________________________________ 
>
>

___________________________________________________________________________________
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  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

documentation

[Yuri Teixeira]

[-- Attachment #1.1: Type: text/plain, Size: 1146 bytes --]

Hello,
I'm sorry this probably is a dumb question but I'm really lost in my
searches. I'm new to context/tex and have been learning/finding information
in the wiki at the contextgarden.net for the past couple of weeks. Some of
information there don't seem up to date but nothing unusual in an
unofficial wiki. For some reason (isp/dns/something) the contextgarden.net
has been unavailiable to me since yesterday even though some verification
sites show it up and some show it down (http://www.isitdownrightnow.com
been one of the later). That got me wondering if there are easy official
docs. I've seen the pdfs at pragma-ade.com but the most general ones I
tried are from 1999 (ms-cb-en.pdf) and 2001 (cont-eni.pdf). Are these up to
date with the current developments? I belive they are compatible but having
seen examples of changes in the wiki I a little unsure. Furthermore, the
parameter behavior description in the command reference seem a bit... dry.
So here's my plea for a little bit more love for the documentation.
In any way, thank you very much for an awesome language, I'm glad I
researched thoroughly before jumping into latex.
YT

[-- Attachment #1.2: Type: text/html, Size: 1404 bytes --]

[-- Attachment #2: Type: text/plain, Size: 485 bytes --]

___________________________________________________________________________________
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
___________________________________________________________________________________

Re: documentation

[Philipp Gesang]

[-- Attachment #1.1: Type: text/plain, Size: 575 bytes --]

···<date: 2014-07-07, Monday>···<from: Yuri Teixeira>···

>                  For some reason (isp/dns/something) the contextgarden.net
> has been unavailiable to me since yesterday even though some verification
> sites show it up and some show it down (http://www.isitdownrightnow.com
> been one of the later).

Confirmed. The wiki server (wiki.contextgarden.net) does not
respond to ICMP requests. I remember having used the wiki only
yesterday so it could be temporary outage. The git server
(git.contextgarden.net) is still running, though.

Best,
Philipp


[-- Attachment #1.2: Type: application/pgp-signature, Size: 819 bytes --]

[-- Attachment #2: Type: text/plain, Size: 485 bytes --]

___________________________________________________________________________________
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
___________________________________________________________________________________

Re: documentation

[Mojca Miklavec]

On Mon, Jul 7, 2014 at 9:10 PM, Philipp Gesang wrote:
> ···<date: 2014-07-07, Monday>···<from: Yuri Teixeira>···
>
>>                  For some reason (isp/dns/something) the contextgarden.net
>> has been unavailiable to me since yesterday even though some verification
>> sites show it up and some show it down (http://www.isitdownrightnow.com
>> been one of the later).
>
> Confirmed. The wiki server (wiki.contextgarden.net) does not
> respond to ICMP requests. I remember having used the wiki only
> yesterday so it could be temporary outage. The git server
> (git.contextgarden.net) is still running, though.

Only wiki, live and modules are down (plus tlcontrib). Minimals and
alike still work.

The domain contextgarden.net points to one server, but apache
redirects to another and that second one is down. This might explain
why verification sites show different results.

Only Taco has access to hardware.

Mojca
___________________________________________________________________________________
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
___________________________________________________________________________________

Re: documentation

[Hans Hagen]

On 7/7/2014 8:51 PM, Yuri Teixeira wrote:
> Hello,
> I'm sorry this probably is a dumb question but I'm really lost in my
> searches. I'm new to context/tex and have been learning/finding
> information in the wiki at the contextgarden.net
> <http://contextgarden.net> for the past couple of weeks. Some of
> information there don't seem up to date but nothing unusual in an
> unofficial wiki. For some reason (isp/dns/something) the
> contextgarden.net <http://contextgarden.net> has been unavailiable to me
> since yesterday even though some verification sites show it up and some
> show it down (http://www..isitdownrightnow.com
> <http://www.isitdownrightnow.com> been one of the later). That got me
> wondering if there are easy official docs. I've seen the pdfs at
> pragma-ade.com <http://pragma-ade.com> but the most general ones I tried
> are from 1999 (ms-cb-en.pdf) and 2001 (cont-eni.pdf). Are these up to
> date with the current developments? I belive they are compatible but
> having seen examples of changes in the wiki I a little unsure.
> Furthermore, the parameter behavior description in the command reference
> seem a bit... dry. So here's my plea for a little bit more love for the
> documentation.
> In any way, thank you very much for an awesome language, I'm glad I
> researched thoroughly before jumping into latex.

When mechanisms in context are extended, we try to remain downward 
compatible, at least in functionality. Therefore the old manuals are 
normally okay (no need to fake updates with newer dates.) There are 
however a few core mechanisms that are obsolete and/or changed and those 
are input encodings (now always utf) and fonts (now always unicode - or 
mapped to unicode - using features cf open type and more).

In practice input encodings and fonts have always been complex: what 
input encoding to choose and what font encoding to use, then running 
into availability of fonts, differences per language, differences per 
user. A bit of installation nightmare and user support as soon as it 
became less standard. By the time that had become easier (tex gyre and 
lm project) the move to opentype was made so most of the documentation 
had become somewhat obsolete.

So, when using old manuals, keep in mind that encodings, regimes and 
fonts are less hassle now and no special commands are needed to use and 
combine these properties.

In addition some mechanisms were extended and improved in mkiv 
(sectioning and so) which means that there are additional ways to 
configure them.

That leaves mechanisms that are completely redone. One example is 
bibliographies, but users who need them will have no real problems 
adapting and these come with new manuals.

Stick to mkiv. It's the one where the action takes place.

Hans

-----------------------------------------------------------------
                                           Hans Hagen | PRAGMA ADE
               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
                                              | www.pragma-pod.nl
-----------------------------------------------------------------
___________________________________________________________________________________
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
___________________________________________________________________________________

Re: documentation

[Yuri Teixeira]

[-- Attachment #1.1: Type: text/plain, Size: 3984 bytes --]

Thank you for the response. I'll keep this description in mind when looking
up stuff and contribute what I can in the wiki (which is still down for me).

YT


2014-07-08 4:57 GMT-03:00 Hans Hagen <pragma@wxs.nl>:

> On 7/7/2014 8:51 PM, Yuri Teixeira wrote:
>
>> Hello,
>> I'm sorry this probably is a dumb question but I'm really lost in my
>> searches. I'm new to context/tex and have been learning/finding
>> information in the wiki at the contextgarden.net
>> <http://contextgarden.net> for the past couple of weeks. Some of
>>
>> information there don't seem up to date but nothing unusual in an
>> unofficial wiki. For some reason (isp/dns/something) the
>> contextgarden.net <http://contextgarden.net> has been unavailiable to me
>>
>> since yesterday even though some verification sites show it up and some
>> show it down (http://www..isitdownrightnow.com
>>
>> <http://www.isitdownrightnow.com> been one of the later). That got me
>> wondering if there are easy official docs. I've seen the pdfs at
>> pragma-ade.com <http://pragma-ade.com> but the most general ones I tried
>>
>> are from 1999 (ms-cb-en.pdf) and 2001 (cont-eni.pdf). Are these up to
>> date with the current developments? I belive they are compatible but
>> having seen examples of changes in the wiki I a little unsure.
>> Furthermore, the parameter behavior description in the command reference
>> seem a bit... dry. So here's my plea for a little bit more love for the
>> documentation.
>> In any way, thank you very much for an awesome language, I'm glad I
>> researched thoroughly before jumping into latex.
>>
>
> When mechanisms in context are extended, we try to remain downward
> compatible, at least in functionality. Therefore the old manuals are
> normally okay (no need to fake updates with newer dates.) There are however
> a few core mechanisms that are obsolete and/or changed and those are input
> encodings (now always utf) and fonts (now always unicode - or mapped to
> unicode - using features cf open type and more).
>
> In practice input encodings and fonts have always been complex: what input
> encoding to choose and what font encoding to use, then running into
> availability of fonts, differences per language, differences per user. A
> bit of installation nightmare and user support as soon as it became less
> standard. By the time that had become easier (tex gyre and lm project) the
> move to opentype was made so most of the documentation had become somewhat
> obsolete.
>
> So, when using old manuals, keep in mind that encodings, regimes and fonts
> are less hassle now and no special commands are needed to use and combine
> these properties.
>
> In addition some mechanisms were extended and improved in mkiv (sectioning
> and so) which means that there are additional ways to configure them.
>
> That leaves mechanisms that are completely redone. One example is
> bibliographies, but users who need them will have no real problems adapting
> and these come with new manuals.
>
> Stick to mkiv. It's the one where the action takes place.
>
> Hans
>
> -----------------------------------------------------------------
>                                           Hans Hagen | PRAGMA ADE
>               Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
>     tel: 038 477 53 69 | voip: 087 875 68 74 | www.pragma-ade.com
>                                              | www.pragma-pod.nl
> -----------------------------------------------------------------
> ____________________________________________________________
> _______________________
> 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
> ____________________________________________________________
> _______________________
>

[-- Attachment #1.2: Type: text/html, Size: 5794 bytes --]

[-- Attachment #2: Type: text/plain, Size: 485 bytes --]

___________________________________________________________________________________
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
___________________________________________________________________________________

Documentation

[Nigel King]

I have tried to use the commands

texutil --documents file.tex

texexec file.ted 

On a number of modules and the texexec fails in a number of places the first
is usually 
! Undefined control sequence.
l.1 \startmodule
                [type=tex]

file in this case is core-tab.tex

What am I doing wrong?
-- 
Nigel

Re: Documentation

[Hans Hagen]

At 08:57 AM 3/7/2002 +0000, Nigel King wrote:
>I have tried to use the commands
>
>texutil --documents file.tex
>
>texexec file.ted
>
>On a number of modules and the texexec fails in a number of places the first
>is usually
>! Undefined control sequence.
>l.1 \startmodule
>                 [type=tex]
>
>file in this case is core-tab.tex
>
>What am I doing wrong?

texexec --modu --pdf core-tab

(the result from texutil needs a style)

Hans
-------------------------------------------------------------------------
                                   Hans Hagen | PRAGMA ADE | pragma@wxs.nl
                       Ridderstraat 27 | 8061 GH Hasselt | The Netherlands
  tel: +31 (0)38 477 53 69 | fax: +31 (0)38 477 53 74 | www.pragma-ade.com
-------------------------------------------------------------------------
                                   fall-back web server: 
www.pragma-ade.nl
-------------------------------------------------------------------------

Re: Documentation

[Nigel King]

>> I have tried to use the commands
>> 
>> texutil --documents file.tex
>> 
>> texexec file.ted
>> 
>> On a number of modules and the texexec fails in a number of places the first
>> is usually
>> ! Undefined control sequence.
>> l.1 \startmodule
>>                 [type=tex]
>> 
>> file in this case is core-tab.tex
>> 
>> What am I doing wrong?
> 
> texexec --modu --pdf core-tab
> 
> (the result from texutil needs a style)
> 
> Hans
texexec is altogether cleverer than I thought one almost doesn't need
texutil independently. The only thing I regularly use texutil for is to
purge after using texexec. You might consider having the --purge switch in
texexec for use after compilation.
-- 
Nigel