Important: ConTeXt Minimals and --delete/--keep switch

Important: ConTeXt Minimals and --delete/--keep switch

[Mojca Miklavec]

Hello,

This is a rather important notice for users of ConTeXt minimals. You
might want to add --keep to ./first-setup.sh

There are some options for which I'm not sure if they should be
enabled by default or not.
The script (mtx-update.lua and consequently the simplistic
./first-setup.sh script) provides two switches:
    --keep and --delete.
The --delete switch deletes all the files that are not part of
distribution. The --keep switch doesn't care about those files (that
have been remove from distribution or that you added) and leaves them
where they are.

Your own files should go to texmf-local that update doesn't touch at all.

Now the important info: if you want your files to be kept, you should
use the --keep switch in ./first-setup.sh. --delete has been
misfunctional for a while, and maybe it should not be kept as the
default option. But as it stands now, it is the default.

Recently there has been a new option added
(--extras=list,of,context,modules), but I would like the option to be
renamed to something more self-explanatory than --extras= (--modules=
for example). You can test if fetching modules works OK, but I would
like to rename the option.

Mojca

(Maybe we should add --cvs-exclude rule to rsync to prevent deleting
kpathsea files and formats.)
___________________________________________________________________________________
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: [Context] Important: ConTeXt Minimals and --delete/--keep switch

[Hans Hagen]

Mojca Miklavec wrote:

> (Maybe we should add --cvs-exclude rule to rsync to prevent deleting
> kpathsea files and formats.)

hm, but formats are regenerated anyway so why bother

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: [Context] Important: ConTeXt Minimals and --delete/--keep switch

[Mojca Miklavec]

On Mon, Dec 1, 2008 at 7:09 PM, Hans Hagen wrote:
> Mojca Miklavec wrote:
>
>> (Maybe we should add --cvs-exclude rule to rsync to prevent deleting
>> kpathsea files and formats.)
>
> hm, but formats are regenerated anyway so why bother

It depends on user. Format generation takes quite some time. When
there is no ConTeXt version or binary update, I usually don't
regenerate formats at all. (There can be a module update or no update
at all, so I have --make switched off.)

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

Re: Important: ConTeXt Minimals and --delete/--keep switch

[Mojca Miklavec]

Hello Alan,

(I'm replying to the mailing list since it's a relatively important issue.)

On Sun, Dec 7, 2008 at 4:32 PM, Alan BRASLAU wrote:
>
> However, I also discovered that first-setup.sh removes the extra modules

It's not first-setup.sh, but mtx-update.lua that does that since a few days.
--delete switch was disfunctional until then, so Hans fixed it in the
way that makes --delete the default option.

> that I downloaded. I therefore created a local script (update.sh). I would
> post this to the context wiki, but I am not sure that this is indeed the
> correct way of doing things.

The correct way of doing things (either is fine):
a) just modify first-setup.sh to include additional --keep switch
b) put your local modifications to texmf-local
c) use --extras=list,of,modules (I would like to convince Hans to
rename that into --modules=)
d) I'm still not sure whether --delete switch as the default option
makes sense or not (in any case, some patches are needed to show which
files will be removed at least).

Mojca



On Mon, Dec 1, 2008 at 6:49 PM, Mojca Miklavec
<mojca.miklavec.lists@gmail.com> wrote:
> Hello,
>
> This is a rather important notice for users of ConTeXt minimals. You
> might want to add --keep to ./first-setup.sh
>
> There are some options for which I'm not sure if they should be
> enabled by default or not.
> The script (mtx-update.lua and consequently the simplistic
> ./first-setup.sh script) provides two switches:
>    --keep and --delete.
> The --delete switch deletes all the files that are not part of
> distribution. The --keep switch doesn't care about those files (that
> have been remove from distribution or that you added) and leaves them
> where they are.
>
> Your own files should go to texmf-local that update doesn't touch at all.
>
> Now the important info: if you want your files to be kept, you should
> use the --keep switch in ./first-setup.sh. --delete has been
> misfunctional for a while, and maybe it should not be kept as the
> default option. But as it stands now, it is the default.
>
> Recently there has been a new option added
> (--extras=list,of,context,modules), but I would like the option to be
> renamed to something more self-explanatory than --extras= (--modules=
> for example). You can test if fetching modules works OK, but I would
> like to rename the option.
>
> Mojca
>
> (Maybe we should add --cvs-exclude rule to rsync to prevent deleting
> kpathsea files and formats.)
___________________________________________________________________________________
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: Important: ConTeXt Minimals and --delete/--keep switch

[Alan BRASLAU]

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

Mojca,

Thanks so much for your help. When all of this gets sorted out, we need to 
update the wiki!

d) I think that it does make sense for --delete to be a default option, 
yielding a clean "minimal" installation.

c) I also think that the --extras=list,of,modules is a fine syntax, as this is 
intended to include extra modules on top of the minimal installation.
(Your suggestion of "--modules=" might be confusing, as many modules, such as 
"bib" or "chemic" to name two that I use, appear to indeed be included as 
standard in the minimal installation.)

I tried "./first-setup.sh --extras=lettrine,tikz", however, this seems to be 
broken: the extra modules were not downloaded. I then tried "--extras=all" and 
now have a "non-minimal minimal" installation with which I'm happy. There 
appears, however, to be a bug in mtx-update.lua... but I haven't learned 
enough yet about its syntax in order to find the error. Sorry!

a) I don't like the idea of modifying first-setup.sh, as problem would be that 
of maintenance as my local version might risk to miss important modifications 
made to this file. My preference is therefore to have locally a simple shell 
script (update.sh):

rsync -ptv rsync://contextgarden.net/minimals/setup/first-setup.sh .
./first-setup.sh --extras=all

or whatever be ones personal preferences.

b) texmf-local is good for other files that have not yet made it into the 
contextgarden (or that will probably not be included). One example of this is 
pgfplots.

Finally, documentation is sorely missing. Of course the wiki will need to be 
updated. I hesitate always to do this until I feel that I really understand 
what is going on. I would also like to see a --help option (to be parsed by 
mtx-update.lua).

Alan

On Sunday 07 December 2008 16:55:00 Mojca Miklavec wrote:
> Hello Alan,
>
> (I'm replying to the mailing list since it's a relatively important issue.)
>
> On Sun, Dec 7, 2008 at 4:32 PM, Alan BRASLAU wrote:
> > However, I also discovered that first-setup.sh removes the extra modules
>
> It's not first-setup.sh, but mtx-update.lua that does that since a few
> days. --delete switch was disfunctional until then, so Hans fixed it in the
> way that makes --delete the default option.
>
> > that I downloaded. I therefore created a local script (update.sh). I
> > would post this to the context wiki, but I am not sure that this is
> > indeed the correct way of doing things.
>
> The correct way of doing things (either is fine):
> a) just modify first-setup.sh to include additional --keep switch
> b) put your local modifications to texmf-local
> c) use --extras=list,of,modules (I would like to convince Hans to
> rename that into --modules=)
> d) I'm still not sure whether --delete switch as the default option
> makes sense or not (in any case, some patches are needed to show which
> files will be removed at least).
>
> Mojca
>
>
>
> On Mon, Dec 1, 2008 at 6:49 PM, Mojca Miklavec
>
> <mojca.miklavec.lists@gmail.com> wrote:
> > Hello,
> >
> > This is a rather important notice for users of ConTeXt minimals. You
> > might want to add --keep to ./first-setup.sh
> >
> > There are some options for which I'm not sure if they should be
> > enabled by default or not.
> > The script (mtx-update.lua and consequently the simplistic
> > ./first-setup.sh script) provides two switches:
> >    --keep and --delete.
> > The --delete switch deletes all the files that are not part of
> > distribution. The --keep switch doesn't care about those files (that
> > have been remove from distribution or that you added) and leaves them
> > where they are.
> >
> > Your own files should go to texmf-local that update doesn't touch at all.
> >
> > Now the important info: if you want your files to be kept, you should
> > use the --keep switch in ./first-setup.sh. --delete has been
> > misfunctional for a while, and maybe it should not be kept as the
> > default option. But as it stands now, it is the default.
> >
> > Recently there has been a new option added
> > (--extras=list,of,context,modules), but I would like the option to be
> > renamed to something more self-explanatory than --extras= (--modules=
> > for example). You can test if fetching modules works OK, but I would
> > like to rename the option.
> >
> > Mojca
> >
> > (Maybe we should add --cvs-exclude rule to rsync to prevent deleting
> > kpathsea files and formats.)


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

[-- Attachment #2: Type: text/plain, Size: 487 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  : https://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________

Re: Important: ConTeXt Minimals and --delete/--keep switch

[Mojca Miklavec]

On Sun, Dec 7, 2008 at 7:35 PM, Alan BRASLAU wrote:
> Mojca,
>
> I tried "./first-setup.sh --extras=lettrine,tikz", however, this seems to be
> broken

Try --extras=t-lettrine,t-tikz. (Maybe providing only lettrine and
tikz should also work - it's not that hard to modify the syntax to fix
that.)

> a) I don't like the idea of modifying first-setup.sh, as problem would be
> that of maintenance as my local version might risk to miss important
> modifications made to this file. My preference is therefore to have locally
> a simple shell script (update.sh):

./first-setup.sh is hardly ever modified. mtx-update.lua gets updated.
But sure - you can have your own local version. first-setup.sh is only
an example how to use mtx-update.lua script.

> b) texmf-local is good for other files that have not yet made it into the
> contextgarden (or that will probably not be included). One example of this
> is pgfplots.

That one is not on the "will-not-be-added" list. I just need to take a
fraction of time to figure out how to set up auto-updating it and
which files are needed. It could be packed together with t-tikz, I
guess.

> Finally, documentation is sorely missing.

You mean documentation for mtx-update.lua itself?

> Of course the wiki will need to be
> updated. I hesitate always to do this until I feel that I really understand
> what is going on. I would also like to see a --help option (to be parsed by
> mtx-update.lua).

Doesn't it work for you (I do not claim that it's informative though)?

MtxRun | version 1.1.0 - 2007+ - PRAGMA ADE / CONTEXT | download tools
MtxRun |
MtxRun | --platform=string     platform (windows, linux, linux-64,
osx-intel, osx-ppc, linux-ppc)
MtxRun | --server=string       repository url (rsync://contextgarden.net)
MtxRun | --module=string       repository url (minimals)
MtxRun | --repository=string   specify version (current, experimental)
MtxRun | --context=string      specify version (current, latest, yyyy.mm.dd)
MtxRun | --rsync=string        rsync binary (rsync)
MtxRun | --texroot=string      installation directory (not guessed for
the moment)
MtxRun | --engine=string       tex engine (luatex, pdftex, xetex)
MtxRun | --extras=string       extra modules (can be list or 'all')
MtxRun | --force               instead of a dryrun, do the real thing
MtxRun | --update              update minimal tree
MtxRun | --make                also make formats and generate file databases
MtxRun | --keep                don't delete unused or obsolete files
MtxRun | --state               update tree using saved state

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