Difference between revisions of "Read Me"

From ConTeXt wiki
m (More information: update bug tracking info)
(updated conversion of mreadme.pdf)
 
Line 3: Line 3:
 
adapted to wiki markup.   
 
adapted to wiki markup.   
  
This page is generated from mreadme.pdf on 2005.11.24.
+
This page is generated from mreadme.pdf on 2019.02.04.
  
----
+
== Read Me First ==
 
 
== Read Me ==
 
  
 
=== Introduction ===
 
=== Introduction ===
  
What licence suits best for a TeX like system is a matter of
+
What licence suits best for a TeX like system is a matter of taste. Personally
taste. Personally we dislike any licence that needs more than a
+
we dislike any licence that needs more than a few pages of dense legal code to
few pages of dense legal code to get the message accross. A TeX
+
get the message across. A TeX related system like ConTeXt is a hybrid of
related system like ConTeXt is a hybrid of programs, scripts and/
+
programs, scripts and/or macro code as well as documentation and sample code,
or macro code as well as documentation and sample code, including
+
including graphics. TeX related systems also have a long standing tradition of
graphics. TeX related systems also have a long standing tradition
+
providing support structures for users. In order to make support feasible, a
of providing support structures for users. In order to make
+
TeX based system like ConTeXt assumes a certain logic and structure in the
support feasable, a TeX based system like ConTeXt assumes a
+
way the related files are named and organized in a tree structure. Even a small
certain logic and structure in the way the related files are
+
change in one of the elements may let such a system behave differently than
named and organized in a tree structure. Even a small change in
+
manuals suggest. Swap a font, change some style defaults, leave out some pieces,
one of the elements may let such a system behave differently than
+
and users may end up in confusion. A licence does not give a user any guarantees!
manuals suggest. Swap a font, change some style defaults, leave
 
out some pieces, and users may end up in confusion. A licence
 
does not give a user any guarantees!
 
 
 
  
In order to satisfy those responsible for distributing ConTeXt,
+
In order to satisfy those responsible for distributing ConTeXt, we need to
we need to choose a licence that makes them feel comfortable.
+
choose a licence that makes them feel comfortable. Unfortunately we don't feel
Unfortunately we don't feel that comfortable with a licence that
+
that comfortable with a licence that does not provide the guarantees that a
does not provide the guarantees that a system will not be adapted
+
system will not be adapted in such ways that the advertised behaviour changes. On
in such ways that the advertised behaviour changes. On the other
+
the other hand, it is the responsibility of those distributing and extending the
hand, it is the responsibility of those distributing and
+
system to make sure that this does not happen. However, users should not
extending the system to make sure that this does not happen.
+
automatically assume that what they get shipped is the same as the original,
However, users should not automatically assume that what they get
+
which is why we stress that support (from our side) will only be given on
shipped is the same as the original, which is why we stress that
+
unaltered systems.
support (from our side) will only be given on unaltered systems.
 
  
First of all, what is ConTeXt? It's just a bunch of macros,
+
First of all, what is ConTeXt? It's just a bunch of macros, written in TeX
written in TeX and METAPOST, meant for typesetting documents. The
+
and MetaPost, meant for typesetting documents. The macros are accompanied by
macros are accompanied by some scripts, written in Perl (mainly
+
some scripts, written in Perl (mainly the older scripts) Ruby (also older
the older scripts) Ruby (the official ones) and Lua (for embedded
+
ones) and Lua (the current fashion). The ConTeXt distribution comes with a
usage). The ConTeXt distribution comes with a few fonts, files
+
few fonts, files that help manage resources (e.g. map files needed for MkII),
that help manage resources (e.g. map files), as well as
+
as well as patterns (based on official ones, so this is a derived work).
patterns (based on official ones, so this is a derived work).
 
  
The ConTeXt distribution is packaged in a zip file organized in the tds structure.  
+
The ConTeXt distribution is packaged in a zip file organised in the TDS
 +
structure.
  
 
<table>
 
<table>
<tr><td><tt>cont-tmf.zip</tt></td><td>&nbsp;&nbsp;The main distribution.</td></tr>
+
<tr><td><tt>cont-tmf.zip</tt></td><td>the main distribution that has all relevant files</td></tr>
<tr><td><tt>cont-img.zip</tt></td><td>&nbsp;&nbsp;A few extra resources. </td></tr>
+
<tr><td><tt>cont-tst.7z</tt></td><td>a bunch of test files that can also serve as examples</td></tr>
<tr><td><tt>cont-ext.zip</tt></td><td>&nbsp;&nbsp;Third party modules. </td></tr>
+
<tr><td><tt>cont-mpd.zip</tt></td><td>a MetaPost to PDF converter (not needed in ConTeXt)</td></tr>
 +
<tr><td><tt>cont-ppc.zip</tt></td><td>a macro package for typesetting chemistry (not needed in ConTeXt)</td></tr>
 +
<tr><td><tt>cont-sci.zip</tt></td><td>configuration files for using ConTeXt in the SciTE editor</td></tr>
 
</table>
 
</table>
When we talk about ConTeXt we also mean its graphical companion
 
MetaFun and foXet, an xml related product. All these are included
 
in the main distribution archive. The documentation can be
 
downloaded from our website, one of its mirrors, the TeX
 
collection as distributed by TeX user groups. For some manuals,
 
source code is available in a subversion repository. The
 
archives are also kept on ctan.
 
  
That said, what licence does apply? We need to distinguish
+
There are two flavours of ConTeXt: MkII and MkIV. The first one is frozen and
between things that resemble a program on the one hand and
+
will not be extended. It runs on top of PdfTeX or XeTeX. The MkIV version is
documentation on the other hand. We (currently) use a different
+
actively developed and runs on top of LuaTeX (an engine that is developed
licence for either of them.
+
alongside ConTeXt but that can also be used for other macro packages).
 +
 
 +
The documentation can be downloaded from our website or the Wiki. Some manuals
 +
ship with source code. We might ship more source code but only when the source is
 +
stable and clean and can serve as an example.
 +
 
 +
That said, what licence does apply? We need to distinguish between things that
 +
resemble a program on the one hand and documentation on the other hand. We
 +
(currently) use a different licence for either of them.
  
 
=== The Code ===
 
=== The Code ===
  
 
+
The program code (i.e. anything not under the <tt>/doc</tt> subtree) is
The program code (i.e. anything not under the <tt>/doc</tt> subtree)
+
distributed under the
is distributed under the  
 
  
 
<div style="color:gray;">
 
<div style="color:gray;">
Line 76: Line 71:
 
</div>
 
</div>
  
For practical purposes distributers may also choose the LaTeX project
+
For practical purposes distributers may also choose the LaTeX project licence,
licence, which is considered to be a bit more TeX friendly. (BSD alike
+
which is considered to be a bit more TeX friendly. (BSD alike licences also
licences, the Ruby Licence and the Apache are all licences that apply
+
apply well for ConTeXt.)
well for ConTeXt.)
+
 
 +
In practice, users may forget about the legal part, if only because I haven't
 +
even read (and understood) it completely myself, so let's stick to what Creative
 +
Commons makes of it:
  
In practice, users may forget about the legal part, if only because I
 
haven't even read  (and understood) it completely myself, so let's
 
stick to what Creative Commons makes of it:
 
  
 
<div style="color:gray;">
 
<div style="color:gray;">
Line 94: Line 89:
 
* The freedom to improve the program and release your improvements to the public, so that the whole community benefits.  
 
* The freedom to improve the program and release your improvements to the public, so that the whole community benefits.  
  
 +
You may exercise the freedoms specified here provided that you comply with the
 +
express conditions of this license. The principal conditions are:
  
You may exercise the freedoms specified here provided that you comply
+
You must conspicuously and appropriately publish on each copy distributed an
with the express conditions of this license. The principal conditions
+
appropriate copyright notice and disclaimer of warranty and keep intact all the
are:
+
notices that refer to this License and to the absence of any warranty; and give
 +
any other recipients of the Program a copy of the GNU General Public License
 +
along with the Program. Any translation of the GNU General Public License must be
 +
accompanied by the GNU General Public License.
  
You must conspicuously and appropriately publish on each copy
+
If you modify your copy or copies of the program or any portion of it, or develop
distributed an appropriate copyright notice and disclaimer of warranty
+
a program based upon it, you may distribute the resulting work provided you do so
and keep intact all the notices that refer to this License and to the
+
under the GNU General Public License. Any translation of the GNU General Public
absence of any warranty; and give any other recipients of the Program
+
License must be accompanied by the GNU General Public License.
a copy of the GNU General Public License along with the Program. Any
 
translation of the GNU General Public License must be accompanied by
 
the GNU General Public License.
 
  
If you modify your copy or copies of the program or any portion of it,
+
If you copy or distribute the program, you must accompany it with the complete
or develop a program based upon it, you may distribute the resulting
+
corresponding machine-readable source code or with a written offer, valid for at
work provided you do so under the GNU General Public License. Any
+
least three years, to furnish the complete corresponding machine-readable source
translation of the GNU General Public License must be accompanied by
+
code.
the GNU General Public License.
 
  
If you copy or distribute the program, you must accompany it with the
+
Any of these conditions can be waived if you get permission from the copyright
complete corresponding machine-readable source code or with a written
+
holder.
offer, valid for at least three years, to furnish the complete
 
corresponding machine-readable source code.
 
 
 
Any of these conditions can be waived if you get permission from the
 
copyright holder.
 
  
 
Your fair use and other rights are in no way affected by the above.
 
Your fair use and other rights are in no way affected by the above.
 
</div>
 
</div>
 +
 +
Many source filed mention the <q>ConTeXt Development Team</q> as
 +
copyright holder. This is because over time users submit patches and whenever
 +
something happens to the main author, those involved in development can take
 +
over without the need to bother about derived work. In the end the ConTeXt
 +
group is the place to get more information.
  
 
=== Recommendations ===
 
=== Recommendations ===
  
Here are a few recommendations in case you want to distribute, extend
+
Here are a few recommendations in case you want to distribute, extend of embed
of embed ConTeXt in applications:  
+
ConTeXt in applications:
  
* You can best leave the code base untouched. Most of ConTeXt provides hooks and it's relatively easy to overload code. Leave the lower level system code untouched: changes may backfire when you update. Asking for more hooks is the best way to go.  
+
*   You can best leave the code base untouched. Most of ConTeXt provides hooks and it's relatively easy to overload code. Leave the lower level system code untouched: changes may backfire when you update. Asking for more hooks is the best way to go.
  
* Put your own code in the right subpaths, i.e. modules approved by the development team under <tt>.../third</tt>, and styles and whatever else under <tt>.../user</tt>. This way your code will not interfere with existing code and updating will give less problems. Keep in mind that TeX systems have their own way and order in locating files, and the load order often matters.  
+
*   Put your own code in the right subpaths, i.e. modules approved by the development team under <tt>.../third</tt>, and styles and whatever else under <tt>.../user</tt>. This way your code will not interfere with existing code and updating will give less problems. Keep in mind that TeX systems have their own way and order in locating files, and the load order often matters.
  
* Don't copy styles and change a few lines, but load the base one and built/patch on top of that. In the end you may benefit from improvements to the base style.  
+
*   Don't copy styles and change a few lines, but load the base one and built/patch on top of that. In the end you may benefit from improvements to the base style.
  
* Be original. The whole idea behind ConTeXt is that you can write your own styles. On the ConTeXt mailing list as well as on the Wiki there are enough advanced users to help you make a start.  
+
*   Be original. The whole idea behind ConTeXt is that you can write your own styles. On the ConTeXt mailing list as well as on the Wiki there are enough advanced users to help you make a start.
  
* Don't hesitate to submit bugs reports and ask for extensions. It may even be that what you want is already present but yet undocumented.  
+
*   Don't hesitate to submit bugs reports and ask for extensions. It may even be that what you want is already present but yet undocumented.
  
* If things don't work as expected, check to what extend your system matches the (more or less) standard. We provide so called minimal ConTeXt trees that can serve as a reference. Because ConTeXt evolves, make sure your system is up to date.
+
*   If things don't work as expected, check to what extend your system matches the (more or less) standard. We provide so called minimal ConTeXt trees that can serve as a reference. Because ConTeXt evolves, make sure your system is up to date. The ConTeXt garden provides ways to install and update the standard distribution.
  
* The scripts can best be called using texmfstart. This lessens dependencies on the location in the tree and ensures upward compatibility. It also prevents clashes with similary named scripts.  
+
*   The scripts can best be called using <tt>mtxrun</tt>. This lessens dependencies on the location in the tree and ensures upward compatibility. It also prevents clashes with similar scripts.
  
* Some scripts depend on each other. Don't mess around with the existing functionality and names of the scripts and then feed them back into the standard distributions.  
+
*   Some scripts depend on each other. Don't mess around with the existing functionality and names of the scripts and then feed them back into the standard distributions.
  
 
=== Documents ===
 
=== Documents ===
  
The documentation is provided under another Creative Commons licence  
+
The documentation is provided under another Creative Commons licence:
  
 
<div style="color:gray;">
 
<div style="color:gray;">
Line 171: Line 168:
 
</div>
 
</div>
  
The non-commercial part is mostly a safeguard. We don't mind if user
+
If you distribute ConTeXt and related software on electronic media as part of
groups distribute printed copies, publish (parts of) manuals and/or if
+
TeX distributions (either or not for money), you may also distribute the
authors use example code in manuals and books about ConTeXt.
+
manuals and their sources in electronic form, preferable as provided by the
 +
maintainers of ConTeXt.
  
Keep in mind that logos and cover designs are not meant to be copied.
+
Keep in mind that logos and cover designs are not meant to be copied. We provide
We provide the source code for some manuals, but we don't always
+
the source code for some manuals, but we don't always provide all graphics and
provide all graphics and other resources. For instance, in some
+
other resources. For instance, in some manuals we use commercial fonts and you
manuals we use commercial fonts and you have to buy those yourself.
+
have to buy those yourself.
  
We provide the typeset manuals at our website. Those are the official
+
We provide the typeset manuals at our website. Those are the official ones. We
ones. We appreciate it if you do not to distribute manuals compiled on
+
appreciate it if you do not to distribute manuals compiled on your own system as
your own system as substitutes. The manuals are a showcase for what
+
substitutes. The manuals are a showcase for what ConTeXt provides. Help us to
ConTeXt provides. Help us to assure the quality.
+
assure the quality.
  
 
=== More information ===
 
=== More information ===
  
We're not going to fill ''n'' pages with legal stuff, so if you
+
We're not going to fill ''n'' pages with legal stuff, so if you want to
want to know more, you have to consult the web for the legalities
+
know more, you have to consult the web for the legalities mentioned. Here are a
mentioned. Here are a few starting points:  
+
few starting points:
 +
 
 +
http://creativecommons.org/licenses/GPL/2.0/ <br>
 +
http://creativecommons.org/licenses/GPL/2.0/legalcode
 +
 
 +
http://creativecommons.org/licenses/by-nc-sa/2.5/ <br>
 +
http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode
 +
 
 +
ConTeXt itself can be fetched from the main site or the garden:
 +
 
 +
http://www.pragma-ade.com <br>
 +
http://context.aanhet.net
 +
 
 +
These always ship the latest versions. Alternatively you can install the whole
 +
TeX distribution, which is a yearly snapshot:
  
http://creativecommons.org/licenses/GPL/2.0/ <br>
+
http://www.tug.org/texlive
http://creativecommons.org/licenses/GPL/2.0/legalcode
 
  
http://creativecommons.org/licenses/by-nc-sa/2.5/ <br>
+
A starting point for support can be found at:
http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode
 
  
ConTeXt itself can be fetched from the main site or its primary mirror:  
+
http://www.ntg.nl/mailman/listinfo/ntg-context <br>
 +
http://contextgarden.net
  
http://www.pragma-ade.com <br>
+
And of course there is the ConTeXt group:
http://context.aanhet.net
 
  
A starting point for support can be found at:  
+
http://group.contextgarden.net
  
http://www.ntg.nl/mailman/listinfo/ntg-context <br>
+
Bugs and feature requests can be registered at the collector:
http://contextgarden.net
 
  
Bugs and feature requests can be registered with the ConTeXt testing project:  
+
http://tracker.luatex.org
  
https://foundry.supelec.fr/projects/contexttest
+
Releases are announced at:
  
Releases are announced at:  
+
http://www.ntg.nl/mailman/listinfo/ann-context
  
http://www.ntg.nl/mailman/listinfo/ann-context
+
The developers can be met at:
  
The developers can be met at:  
+
http://www.ntg.nl/mailman/listinfo/dev-context
  
http://www.ntg.nl/mailman/listinfo/dev-context
+
=== Disclaimer ===
  
=== Disclaimer ===
+
To play safe we include a disclaimer here, taken from the BSD style licence. For
To play safe we include a disclaimer here, taken from the
+
some reason such a text is always in unreadable capitals, so ...
BSD style licence. For some reason such a text is in capitals, so ...
 
  
 
<div style="color:gray;">
 
<div style="color:gray;">
 
THIS SOFTWARE IS PROVIDED BY THE AUTHOR “AS IS” AND ANY EXPRESS OR
 
THIS SOFTWARE IS PROVIDED BY THE AUTHOR “AS IS” AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+
IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+
NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
POSSIBILITY OF SUCH DAMAGE.
 
 
</div>
 
</div>
... and don't bother discussing licence issues and related things with
 
us for the mere sake of discussing licence stuff.
 
  
 +
... and don't bother discussing licence issues and related things with us
 +
for the mere sake of discussing licence stuff.
  
: PRAGMA
+
: Hans Hagen
: Advanced Document Engineering  
+
: PRAGMA Advanced Document Engineering  
: Ridderstraat 27
+
: Hasselt NL
: 8061GH Hasselt NL  
 
: tel: +31 (0)38 477 53 69
 
: email: [mailto:pragma@wxs.nl pragma@wxs.nl]
 
: internet: [http://www.pragma-ade.com www.pragma-ade.com]
 

Latest revision as of 09:45, 4 February 2019

What follows is the text from [mreadme.pdf], adapted to wiki markup.

This page is generated from mreadme.pdf on 2019.02.04.

Read Me First

Introduction

What licence suits best for a TeX like system is a matter of taste. Personally we dislike any licence that needs more than a few pages of dense legal code to get the message across. A TeX related system like ConTeXt is a hybrid of programs, scripts and/or macro code as well as documentation and sample code, including graphics. TeX related systems also have a long standing tradition of providing support structures for users. In order to make support feasible, a TeX based system like ConTeXt assumes a certain logic and structure in the way the related files are named and organized in a tree structure. Even a small change in one of the elements may let such a system behave differently than manuals suggest. Swap a font, change some style defaults, leave out some pieces, and users may end up in confusion. A licence does not give a user any guarantees!

In order to satisfy those responsible for distributing ConTeXt, we need to choose a licence that makes them feel comfortable. Unfortunately we don't feel that comfortable with a licence that does not provide the guarantees that a system will not be adapted in such ways that the advertised behaviour changes. On the other hand, it is the responsibility of those distributing and extending the system to make sure that this does not happen. However, users should not automatically assume that what they get shipped is the same as the original, which is why we stress that support (from our side) will only be given on unaltered systems.

First of all, what is ConTeXt? It's just a bunch of macros, written in TeX and MetaPost, meant for typesetting documents. The macros are accompanied by some scripts, written in Perl (mainly the older scripts) Ruby (also older ones) and Lua (the current fashion). The ConTeXt distribution comes with a few fonts, files that help manage resources (e.g. map files needed for MkII), as well as patterns (based on official ones, so this is a derived work).

The ConTeXt distribution is packaged in a zip file organised in the TDS structure.

cont-tmf.zipthe main distribution that has all relevant files
cont-tst.7za bunch of test files that can also serve as examples
cont-mpd.zipa MetaPost to PDF converter (not needed in ConTeXt)
cont-ppc.zipa macro package for typesetting chemistry (not needed in ConTeXt)
cont-sci.zipconfiguration files for using ConTeXt in the SciTE editor

There are two flavours of ConTeXt: MkII and MkIV. The first one is frozen and will not be extended. It runs on top of PdfTeX or XeTeX. The MkIV version is actively developed and runs on top of LuaTeX (an engine that is developed alongside ConTeXt but that can also be used for other macro packages).

The documentation can be downloaded from our website or the Wiki. Some manuals ship with source code. We might ship more source code but only when the source is stable and clean and can serve as an example.

That said, what licence does apply? We need to distinguish between things that resemble a program on the one hand and documentation on the other hand. We (currently) use a different licence for either of them.

The Code

The program code (i.e. anything not under the /doc subtree) is distributed under the

For practical purposes distributers may also choose the LaTeX project licence, which is considered to be a bit more TeX friendly. (BSD alike licences also apply well for ConTeXt.)

In practice, users may forget about the legal part, if only because I haven't even read (and understood) it completely myself, so let's stick to what Creative Commons makes of it:


The GNU General Public License is a Free Software license. Like any Free Software license, it grants to you the four following freedoms:

  • The freedom to run the program for any purpose.
  • The freedom to study how the program works and adapt it to your needs.
  • The freedom to redistribute copies so you can help your neighbour.
  • The freedom to improve the program and release your improvements to the public, so that the whole community benefits.

You may exercise the freedoms specified here provided that you comply with the express conditions of this license. The principal conditions are:

You must conspicuously and appropriately publish on each copy distributed an appropriate copyright notice and disclaimer of warranty and keep intact all the notices that refer to this License and to the absence of any warranty; and give any other recipients of the Program a copy of the GNU General Public License along with the Program. Any translation of the GNU General Public License must be accompanied by the GNU General Public License.

If you modify your copy or copies of the program or any portion of it, or develop a program based upon it, you may distribute the resulting work provided you do so under the GNU General Public License. Any translation of the GNU General Public License must be accompanied by the GNU General Public License.

If you copy or distribute the program, you must accompany it with the complete corresponding machine-readable source code or with a written offer, valid for at least three years, to furnish the complete corresponding machine-readable source code.

Any of these conditions can be waived if you get permission from the copyright holder.

Your fair use and other rights are in no way affected by the above.

Many source filed mention the ConTeXt Development Team as copyright holder. This is because over time users submit patches and whenever something happens to the main author, those involved in development can take over without the need to bother about derived work. In the end the ConTeXt group is the place to get more information.

Recommendations

Here are a few recommendations in case you want to distribute, extend of embed ConTeXt in applications:

  • You can best leave the code base untouched. Most of ConTeXt provides hooks and it's relatively easy to overload code. Leave the lower level system code untouched: changes may backfire when you update. Asking for more hooks is the best way to go.
  • Put your own code in the right subpaths, i.e. modules approved by the development team under .../third, and styles and whatever else under .../user. This way your code will not interfere with existing code and updating will give less problems. Keep in mind that TeX systems have their own way and order in locating files, and the load order often matters.
  • Don't copy styles and change a few lines, but load the base one and built/patch on top of that. In the end you may benefit from improvements to the base style.
  • Be original. The whole idea behind ConTeXt is that you can write your own styles. On the ConTeXt mailing list as well as on the Wiki there are enough advanced users to help you make a start.
  • Don't hesitate to submit bugs reports and ask for extensions. It may even be that what you want is already present but yet undocumented.
  • If things don't work as expected, check to what extend your system matches the (more or less) standard. We provide so called minimal ConTeXt trees that can serve as a reference. Because ConTeXt evolves, make sure your system is up to date. The ConTeXt garden provides ways to install and update the standard distribution.
  • The scripts can best be called using mtxrun. This lessens dependencies on the location in the tree and ensures upward compatibility. It also prevents clashes with similar scripts.
  • Some scripts depend on each other. Don't mess around with the existing functionality and names of the scripts and then feed them back into the standard distributions.

Documents

The documentation is provided under another Creative Commons licence:

Attribution NonCommercial ShareAlike

This one says:

You are free:

  • to copy, distribute, display, and perform the work
  • to make derivative works

ATTRIBUTION: You must attribute the work in the manner specified by the author or licensor.

NONCOMMERCIAL: You may not use this work for commercial purposes.

SHARE ALIKE: If you alter, transform, or build upon this work, you may distribute the resulting work only under a license identical to this one.

  • For any reuse or distribution, you must make clear to others the license terms of this work.
  • Any of these conditions can be waived if you get permission from the copyright holder.

Your fair use and other rights are in no way affected by the above.

If you distribute ConTeXt and related software on electronic media as part of TeX distributions (either or not for money), you may also distribute the manuals and their sources in electronic form, preferable as provided by the maintainers of ConTeXt.

Keep in mind that logos and cover designs are not meant to be copied. We provide the source code for some manuals, but we don't always provide all graphics and other resources. For instance, in some manuals we use commercial fonts and you have to buy those yourself.

We provide the typeset manuals at our website. Those are the official ones. We appreciate it if you do not to distribute manuals compiled on your own system as substitutes. The manuals are a showcase for what ConTeXt provides. Help us to assure the quality.

More information

We're not going to fill n pages with legal stuff, so if you want to know more, you have to consult the web for the legalities mentioned. Here are a few starting points:

http://creativecommons.org/licenses/GPL/2.0/ 
http://creativecommons.org/licenses/GPL/2.0/legalcode
http://creativecommons.org/licenses/by-nc-sa/2.5/ 
http://creativecommons.org/licenses/by-nc-sa/2.5/legalcode

ConTeXt itself can be fetched from the main site or the garden:

http://www.pragma-ade.com 
http://context.aanhet.net

These always ship the latest versions. Alternatively you can install the whole TeX distribution, which is a yearly snapshot:

http://www.tug.org/texlive

A starting point for support can be found at:

http://www.ntg.nl/mailman/listinfo/ntg-context 
http://contextgarden.net

And of course there is the ConTeXt group:

http://group.contextgarden.net 

Bugs and feature requests can be registered at the collector:

http://tracker.luatex.org

Releases are announced at:

http://www.ntg.nl/mailman/listinfo/ann-context

The developers can be met at:

http://www.ntg.nl/mailman/listinfo/dev-context

Disclaimer

To play safe we include a disclaimer here, taken from the BSD style licence. For some reason such a text is always in unreadable capitals, so ...

THIS SOFTWARE IS PROVIDED BY THE AUTHOR “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

... and don't bother discussing licence issues and related things with us for the mere sake of discussing licence stuff.

Hans Hagen
PRAGMA Advanced Document Engineering
Hasselt NL