gardener, Interface administrators, Administrators
1,546
edits
Changes
m
[[User:Taco|Taco]] 14:26, 31 May 2005 (CEST)----== Read Me First ==
=== Preamble === There are two flavours of ConTeXt: MkII and MkIV. The first one is frozen andwill not be extended. It runs on top of PdfTeX or XeTeX. The MkIV version isactively developed and runs on top of LuaTeX (an engine that is developedalongside ConTeXt but that can also be used for other macro packages).
This document presents licence information on ConTeXt, a macro packagewritten in The documentation can be downloaded from our website or the typographical programming language TeXWiki. This documentSome manualsship with source code. We might ship more source code but only when the source is ''not'' stable and clean and can serve as an installation manualexample. For installation of ConTeXt and itsaccompanying programs we refer to the following documents:
* [[http://www.pragma-ade.com/general/manuals/minstall.pdf How That said, what licence does apply? We need to install ConTeXt]]distinguish between things that* [[http://wwwresemble a program on the one hand and documentation on the other hand.pragma-ade.com/general/manuals/mtexexec.pdf TeXexec explained]]We* [[http://www.pragma-ade.com/general/manuals/mtexutil(currently) use a different licence for either of them.pdf TeXutil explained]]
In addition you may need the introduction and/or referencemanual. There are more documents, but you need only these to getstarted. Unless you are going to change and redistribute ConTeXt, youcan quit reading now.=== The Code ===
'''[1.1]''' The name ConTeXt is reserved for the distribution as
provided by Pragma ADE. This distribution is copyrighted and licensed in the
spirit of the gnu general public licence. To prevent inconsistency in
distributions and to ease support, we will stress some details of
adapting sources and distributions.
'''[1<div style="color:gray;">The GNU General Public License is a Free Software license.2]''' The ConTeXt distribution includes TeX macro files as well asLike any Free Software some utility programs written in Perllicense, Perl/Tk, and Ruby as well asgraphic macros written in it grants to you the METAPOST language. The same conditionsapply to all files. four following freedoms:
'''[1* The freedom to run the program for any purpose.3]''' * The logos associated freedom to Pragma ADE, ConTeXt, TeXutil study how the program works and relatedadapt it to your needs. * The freedom to redistribute copies so you can help your neighbour. programs are copyrighted by Pragma ADE * The freedom to improve the program and may not be used for otherpurposes than their intended usage without permissionrelease your improvements to the public, so that the whole community benefits.
'''[1.4]''' Whenever one of You may exercise the source files of ConTeXt mentions freedoms specified here provided that you comply with the filebeing copyrighted by Pragma ADE, the express conditions mentioned in of thisdocument applylicense.The principal conditions are:
=== Principles ===You must conspicuously and appropriately publish on each copy distributed anappropriate copyright notice and disclaimer of warranty and keep intact all thenotices that refer to this License and to the absence of any warranty; and giveany other recipients of the Program a copy of the GNU General Public Licensealong with the Program. Any translation of the GNU General Public License must beaccompanied by the GNU General Public License.
'''[2.1]''' Pragma ADE originally developed ConTeXt for producing highlystructured documents as used in educational settings and processIf you modify your copy or copies of the program or any portion of it, or developindustry. Currently ConTeXt is used by publishers and in educationa program based upon it, inyou may distribute the resulting work provided you do soprofit and non profit organizationsunder the GNU General Public License. There are also numerous privateAny translation of the GNU General Publicusers. These all depend on ConTeXt being stable systemLicense must be accompanied by the GNU General Public License.
'''[2.2]''' One of If you copy or distribute the objectives of ConTeXt is program, you must accompany it with the low entry levelcompletecorresponding machine-readable source code or with a written offer, thatvalid for atisleast three years, for day-tofurnish the complete corresponding machine-day use no special technical (and no in-depth TeX)knowledge is needed. This is reflected in the user interface. We don'texpect users to be experts on installing TeX and adapting macros forreadable sourcelocal usecode.
'''[2.3]''' We try to keep ConTeXt in sync with developments inpublishing. So far this has lead to support for output formats likepdf and alternative coding standards like xml. It has also resulted inAny of these conditions can be waived if you get permission from the copyrighta couple of user interfaces and toolsholder.
'''[2.4]''' Further development of ConTeXt takes place at Pragma ADE withthe help Your fair use and input from some active users. All kinds of comment fromusers is welcomed and will be taken seriously. When we talk aboutConTeXt, we refer to the version as distributed other rights are in no way affected by Pragma ADE anddescribed in the official reference manualabove. </div>
'''[2.5]''' Many source filed mention the <q>ConTeXt consists of several series of modules, that can berecognized by the fact that the filename starts with four charactersDevelopment Team</q> ascopyright holder. This is because over time users submit patches and a dash. These core modules take care of languages, fonts, generalwhenevertypography, data abstraction, and manipulations. On top of this coresomething happens to the main author,those involved in development can takedomain and task specific modules and styles are (and will become)availableover without the need to bother about derived work. These can be recognized by their filename that start with aIn the end the ConTeXtcharacter followed by a dashgroup is the place to get more information.
'''[2.6]''' For special purposes, not covered by existing functionality,users can write their own extensions. ConTeXt provides hooks into thecore routines. These are documented in the source code. === Recommendations ===
'''[2.7]''' ConTeXt is available for free for everyone who Here are a few recommendations in case you want to usedistribute, extend of embedit. Distributors are free to choose between the latest officialrelease and the (ConTeXt in most cases stable) beta version. applications:
'''[2* Put your own code in the right subpaths, i.9]''' Modules to ConTeXt or adapted source code written e. modules approved by Pragma ADEfor the development team under <tt>.../third parties as part of a project may </tt>, and styles and whatever else under <tt>.../user</tt>. This way your code will not be distributed outsideinterfere with existing code and updating will give less problems. Keep in mind that organization. They may become part of TeX systems have their own way and order in locating files, and the public distribution,upon mutual agreementload order often matters.
=== Public version ===* 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.
'''[3* Be original.1]''' The whole idea behind ConTeXt is available that you can write your own styles. On the ConTeXt mailing list as free software in the spirit of well as on the gnugeneral public licenceWiki there are enough advanced users to help you make a start.
'''[3* The scripts can best be called using <tt>mtxrun</tt>.4]''' This licence does not automatically apply to third partyextensionslessens dependencies on the location in the tree and ensures upward compatibility. It also prevents clashes with similar scripts.
=== Third party developments ===* 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.
'''[4.1]''' This sections will not introduce limitations in use thatconflict with the gnu general public licence. We only want to makesure that the average user will get the ConTeXt they expect and thatwe can continue to support users efficiently. === Documents ===
'''[4.2]''' Users are encouraged to develop modules cq. layout definitionfiles for ConTeXt. However, the interface of such modules should fitthe general scheme philosophy. The documentation is provided under another Creative Commons licence:
'''[4.3]''' Keywords and command names should conform to the already defined<div style="color:gray;">ones and therefore not clash with existing functionality. An example:Attribution NonCommercial ShareAlike of extending the user interface can be seen in the ppchTeX</div>module. This one says:
'''[4.4]''' On request<div style="color:gray;">You are free: * to copy, additional keywords and command names can beapproved and/or assigned by the ConTeXt Task Force anddistribute, when accepteddisplay,will be added to and perform the validated definition files. The same applies towork the names of files and auxiliary variables. These should conform * tothe naming scheme laid down in the documentation. make derivative works
'''[4.5]''' Third party modules (and layout files) will not automaticallybecome part of ATTRIBUTION: You must attribute the ConTeXt distribution, but will be collected anddistributed separately. One reason for this is that they fall outsidethe maintainance responsibility of Pragma ADE. This also means thatfor instance work in the texmf directory structure, the context/base,context/extra and context/sample locations are reserved for manner specified by theofficial distribution. Additions should go into context/third and userspecific things into context/userauthor or licensor.
'''[4.6]''' We strongly advice users who write their own macros NONCOMMERCIAL: You may not use this work for ConTeXt,to package them in document specific environments or third partymodules (prefixed by t-)commercial purposes.
'''[4.7]''' Users SHARE ALIKE: If you alter, transform, or build upon this work, you may not change distribute the official distribution and redistributethat changed version as official. This will ensure the integrity ofConTeXt. Local settings cq. bug fixes can be added in the filescont-sys and cont-new. Distributers may add configuration settings resulting work only under a license identical tocont-usr and cont-systhis one.
'''[4.8]''' When adapted versions of ConTeXt are distributed* For any reuse or distribution, these versionsyou must contain make clear to others the original distribution as a separate item. The runtimeversions (format files) must have different names and changed filesmust have an additional \writestatus message, expressing thatsomething is changed. The rationale behind license terms of this is that some modulesare generic, and are sometimes distributed on request separatelywork. Whendistributing self contained modules and styles, a full distribution * Any oforiginals is not requiredthese conditions can be waived if you get permission from the copyright holder.
'''[4.9]''' Because many TeX systems support recursive directory search,those who write extensions or change files, must make sure that Your fair use and other rights are in no way affected by theoriginal ConTeXt does not suffer from loading the wrong files. Werealize that this is not always easy, but please keep in mind thatthere are many users who cannot sort out these problemsabove. Together wemust guarantee that when users want to run original ConTeXt, nothingunexpected is loaded, because it makes support nearlyimpossible. </div>
'''[4.10]''' Because If you distribute ConTeXt is a monolithic system, and because programmingrelated software on electronic media as part ofhooks are providedTeX distributions (either or not for money), adaptations and extensions should be put you may also distribute themanuals and/orloaded their sources in electronic form, preferable as provided by the file cont-new which itself is loaded at run time. Thatway, users can still benefit from official updatesmaintainers of ConTeXt.
'''[4Keep in mind that logos and cover designs are not meant to be copied.11]We providethe source code for some manuals, but we don''' The auxiliary programs may be adapted to local conditions, sucht always provide all graphics andas operating systems specificsother resources. The functionality however must not beFor instance, in some manuals we use commercial fonts and youchangedhave to buy those yourself.
'''[4We provide the typeset manuals at our website.12]''' The same rules apply for Those are the METAPOST macro files official ones. Weappreciate 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 toassure theTeX macro filesquality.
'''[4.13]''' Support of the official public version of ConTeXt is availablefrom the ConTeXt mailing list hosted by the ntg.=== More information ===
=== Manuals ===We're not going to fill ''n'' pages with legal stuff, so if you want toknow more, you have to consult the web for the legalities mentioned. Here are afew starting points:
'''[5 http://creativecommons.1]''' User manuals, reference documentation, module related manuals,quick reference guides, up-to-date documents, faqs, documentedsources, are available in printable andorg/licenses/GPL/or electronic form at thePragma ADE site and its mirrors2. These documents are copyrighted by0/ <br>Pragma ADE and serve as reference to the official version http://creativecommons. You mayprint them and give away copiesorg/licenses/GPL/2. 0/legalcode
'''[5 http://creativecommons.org/licenses/by-nc-sa/2]''' .5/ <br> Users are invited to provideadditional documentation to usershttp://creativecommons. The official documentation providedorg/licenses/by Pragma ADE is maintained by and generated at Pragma ADE andavailable at its website. Pointers to third party contributions can befound at the Pragma ADE website-nc-sa/2.5/legalcode
'''[5.3]''' Because the manuals provided by Pragma ADE are also examples ofwhat ConTeXt itself can be done with ConTeXt, their layout is bound to thesedocuments. This also applies to the ConTeXt demonstrationsuite. Therefore, in order to avoid confusion, we strongly adviceauthors of third party documentation and demos not to use fetched from the samelayout characteristics, graphics and special tricks. Examples ofcoding and tricks can be found in main site or the style files that come withConTeXt.garden:
=== Guarantees === http://www.pragma-ade.nl <br> http://context.aanhet.net
'''[6These always ship the latest versions.1]''' Pragma ADE cannot guarantee the typographic quality and Alternatively you can install thewholefunctionality of the ConTeXt output. TeX distribution, which is a yearly snapshot:
'''[6.2]''' Typographic optimizations will be implemented and wishescq. suggestions of users will be be honoured when possiblehttp://www. The bestway to communicate this is the ConTeXt mailing listtug. org/texlive
'''[6.3]''' When additional functionality is provided, downwardcompatibility will A starting point for support can be guarded as good as possible. found at:
'''[6 http://www.4]''' Users of experimental modules should be aware of the fact thatdue to further optimization and consistency, the functionality willonly be stable when explicitly statedntg. The common user will hardlynl/mailman/listinfo/ntg-context <br>notice this limitation http://contextgarden. net
'''[6.5]''' Some core modules can be classified as generic, that And of course there is, theywork with other macro packages as well (for instance supp-pdf). You mayinstall them separately on your system, but in order to preventconflicts in versions, we strongly advice separating them from thedistributions. ConTeXt group:
'''[6 http://group.6]''' Undocumented macros and functionality are subjected tooptimizations and relying on their presence can be "dangerous"contextgarden.net
=== Distribution === Bugs and feature requests can be registered at the collector:
'''[7.1]''' The official ConTeXt archive is available at the Pragma ADE wwwsite, as well as on mirrors of this site, provided by the ntg, ctan,and othershttp://tracker. The free TeX distributions teTeX and fpTeX can beconsidered as a references to integrating ConTeXt into other TeXsystemsluatex. org
'''[7.2]''' We hereby grant permission to the de facto official TeXdistributors teTeX, fpTeX and TeXlive to replace this licence withtheir own, i.e. their licence may supersede or enhance this one.Releases are announced at:
'''[7.3]''' ConTeXt may The developers can be distributed as part of a public distribution inthe spirit of free distributions. The authors of ConTeXt appreciatebeing notified on this. met at:
'''[7 http://www.4]''' Each distribution of ConTeXt should include a copy of this textntg.nl/mailman/listinfo/dev-context
Because To play safe we don't want to be confronted with funny claims as include a sidedisclaimer here, taken from the BSD style licence. Foreffect of providing free softwaresome reason such a text is always in unreadable capitals, we add a few disclaimersso ...
'''[8<div style="color:gray;">THIS SOFTWARE IS PROVIDED BY THE AUTHOR “AS IS” AND ANY EXPRESS ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIESOF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.1]''' By modifying or distributing the program IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (or any work based onINCLUDING, BUTthe program)NOT LIMITED TO, you indicate your acceptance of this license to do soPROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,and all its terms and conditions for copyingDATA, distributing orOR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANYmodifying the program or works based on it. Nothing other than thisTHEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORTlicense grants you permission to modify or distribute the program or(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OFits derivative works. These actions are prohibited by lawTHIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. If you donot accept these terms and conditions, do not modify or distribute theprogram. </div>
'''[8.2]''' The program is provided to you "as is", without warranty. Thereis no warranty for the program, either expressed or implied,including, but not limited to, the implied warranties ofmerchantability . and fitness for a particular purpose andnoninfringement of third party rights. The entire risk as to thequality don't bother discussing licence issues and performance of the program is related things with you. should the programusprove defective, you assume for the cost mere sake of all necessary servicing,repair or correctiondiscussing licence stuff.
'''[8.3]''' In no event unless required by applicable law or agreed to in: Hans Hagenwriting will licensor, or any other party who may modify and/or: PRAGMA Advanced Document Engineering redistribute the program as permitted above, be liable to you fordamages, including any general, special, incidental or consequentialdamages arising out of the use or inability to use the program(including but not limited to loss of data or data being renderedinaccurate or losses sustained by you or third parties or a failure ofthe program to operate with any other programs), even if such holderor other party has been advised of the possibility of such damages.: Hasselt NL
: PRAGMA: Advanced Document Engineering : Ridderstraat 27 : 8061GH Hasselt NL : tel: +31 (0)38 477 53 69 : email: [mailto[Category:pragma@wxs.nl pragma@wxs.nlDevelopment]: internet: [http://www.pragma-ade.com www.pragma-ade.com]
fix pragma links
What follows is the text from
[[httpmanual://www.pragma-ade.com/general/manuals/mreadme.pdf |mreadme.pdf]],
adapted to wiki markup.
This page is generated from mreadme.pdf on 20052019.0502.3104.
== Read Me =Introduction === What licence suits best for a TeX like system is a matter of taste. Personallywe dislike any licence that needs more than a few pages of dense legal code toget the message across. A TeX related system like ConTeXt is a hybrid ofprograms, scripts and/or macro code as well as documentation and sample code,including graphics. TeX related systems also have a long standing tradition ofproviding support structures for users. In order to make support feasible, aTeX based system like ConTeXt assumes a certain logic and structure in theway the related files are named and organized in a tree structure. Even a smallchange in one of the elements may let such a system behave differently thanmanuals 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 tochoose a licence that makes them feel comfortable. Unfortunately we don't feelthat comfortable with a licence that does not provide the guarantees that asystem will not be adapted in such ways that the advertised behaviour changes. Onthe other hand, it is the responsibility of those distributing and extending thesystem to make sure that this does not happen. However, users should notautomatically 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 onunaltered systems. First of all, what is ConTeXt? It's just a bunch of macros, written in TeXand MetaPost, meant for typesetting documents. The macros are accompanied bysome scripts, written in Perl (mainly the older scripts) Ruby (also olderones) and Lua (the current fashion). The ConTeXt distribution comes with afew 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 TDSstructure. <table><tr><td><tt>cont-tmf.zip</tt></td><td>the main distribution that has all relevant files</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-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>
The program code (i.e. anything not under the <tt>/doc</tt> subtree) isdistributed under the <div style=== Introduction ==="color:gray;">: [http://creativecommons.org/licenses/GPL/2.0/ Creative Commons GNU GPL]</div> For practical purposes distributers may also choose the LaTeX project licence,which is considered to be a bit more TeX friendly. (BSD alike licences alsoapply well for ConTeXt.) In practice, users may forget about the legal part, if only because I haven'teven read (and understood) it completely myself, so let's stick to what CreativeCommons makes of it:
* You can best leave the code base untouched. Most of ConTeXt provides hooks and it'''[2s relatively easy to overload code. Leave the lower level system code untouched: changes may backfire when you update.8]''' Experimental, and thereby potentially non-stable, versions aswell as certain dedicated modules, will be distributed under differentconditionsAsking for more hooks is the best way to go.
* Don'''[3t hesitate to submit bugs reports and ask for extensions.2]''' This public version It may even be that what you want is the "official public ConTeXtdistribution". However, ConTeXt as part of one of the TeXdistributions supported by user groups can also be classified asofficialalready present but yet undocumented.
* If things don'''[3.3]''' The official version t work as expected, check to what extend your system matches the (imore or less) standard.e. the original zipped archiverecognized by the prefix cont-) may only be redistributed We provide so called minimal ConTeXt trees that can serve as a wholereference. Because ConTeXt evolves, make sure your system is up to date. The ConTeXt garden provides ways to install and under this licenceupdate the standard distribution.
http://www.ntg.nl/mailman/listinfo/ann-context
=== Additional disclaimers Disclaimer ===