Products         Customers         News         Downloads         Licensing         Shop    

 DocFlex Technology
Overview
Features
Documentation
 DocFlex/XML
Overview
Features
Documentation
XSDDoc
WSDLDoc
Integrations
Bundles
 DocFlex/Javadoc
Overview
Documentation
Basic Templates
JavadocPro
Examples
Tutorials
 DocFlex/Together
Overview
Examples
Basic Templates
Documentation
Tutorials
 Try
Downloads
Registration
Trial License
 Buy
Licensing
Shop
 Company
News
Products
Customers
About Us
Imprint
Legal
Contact
Links
 

Licensing

  1. Free License
  2. Limited Free License
  3. Trial License
  4. Commercial License
  5. Academic License
  6. Licensing of Templates
  7. Multiple Licenses
  8. Getting Help

1.  Free License

The Free License applies to certain editions of Filigris Works products and allows you to use that Software for any purpose free of charge.

The Software provided under the Free License may also be redistributed as part of any other application on condition that such a redistribution reproduces the copyright notice 'Copyright© 2002-2009 Filigris Works, Leonid Rudy Softwareprodukte. All rights reserved.' and includes the license terms provided with the Software by Filigris Works.

Generated Output

The output documentation generated under Free License is free for any possible usage. In particular:
  • You may change the content of the generated files in any way you need, e.g. edit/remove some blocks, add your own, etc.
  • You are free to distribute your generated/modified documents with no limitations.

Templates

The Free License does not allow you to create or modify any templates.

You are not entitled under this license to redistribute any separate templates either.

The Free License allows you:

  • To execute any templates provided with this software (covered by the Free License).
  • To execute any custom templates created/modified using the full edition of the given product line (which includes the Template Designer) working under a Commercial License.
For further information, please see Licensing of Templates section.

2.  Limited Free License

Limited Free License is currently provided for almost all Filigris Works products.

You are entitled to a Limited Free License free of charge once you have downloaded the software covered by it. The license is activated automatically each time you run the software. No registration is required for this.

Under the Limited Free License, the software will work in limited mode. Not all features supported by this software will be available for your use.

The Limited Free License does not allow you to redistribute the software. (Anyone willing to use it should download the software directly from the Filigris Works website.)

The Limited Free License has no limitation in time. You may use the software under the Limited Free License so long as you comply with the license terms.

Generated Output

The output documentation generated under Limited Free License may be used only in accordance with the following restrictions:
  • You may use the documentation for any puposes you need (including commercial).
  • You may not change the content of any generated HTML files (including deleting of any advertisements of the DocFlex software).
  • The content of the generated RTF files may be changed.
  • You are free to distribute your generated/modified documents with no limitations.

Templates

The Limited Free License does not allow you to create or modify any templates.

The Template Designer will work under this license only in demo mode. You may investigate any functionality you wish, but you cannot save your created/modified templates.

Under the Limited Free License, you may execute only the templates provided with this software (covered by the license).

For further information, please see Licensing of Templates section.

3.  Trial License

Trial Licenses are provided for those Software products of Filigris Works that are available for Commercial Licensing.

A Trial License allows you to use the fully functional Software product for free during 15 days (or 30 days) for evaluation purposes only.

A Trial License is generated automatically per your request and the license certificate is emailed to the provided address. The license certificate represents a plain text file with the information about your license. The received license file should be installed together with the installed Software according to the provided instruction.

You may request for an extension of your Trial License for another 15 days (30 days). However, that possibility may be limited.

Generated Output

The output files generated under the Trial License may be used for evaluation purposes only. You are strictly prohibited to use the generated documentation (or any parts of it) for your job tasks.

To enforce this condition, all output documents generated (in HTML and RTF formats) under the Trial License will be heavily distorted by replacing some letters with bullet ('•') characters (as well as contain special messages).

As soon as you acquire a full license, no text distortion and trial messages will appear! See also Special Trial License.

Templates

Any templates created/modified under the Trial License may be used for evaluation purposes only.

You may not distribute those templates to anyone else (e.g. to someone who already has a commercial or academic license) and in such a way to circumvent buying the full license by yourself.

The templates created/modified under the Trial License will not work with any of the reduced editions of the given product line (e.g. DocFlex/XML RE or DocFlex/Doclet).

Note:   To remove that limitation (above), you should resave the templates after you have purchased and installed the full Commercial License.

The Trial License allows you to execute any custom templates (created by someone under a Commercial License). However, any output files generated with such templates may be used for evaluation only!

For further information, please see Licensing of Templates section.

Special Trial License

For those our prospective customers, who try our commercial products not only for a mere curiosity but seriously considering using them in their projects, to help with the product evaluation, we may provide a Special Trial License.

The difference from the general Trial License generated automatically by this web-site is that not only all features will be unlocked but also no text distortion will be made. Everything will look the same as generated under the full Commercial License!

To apply for a Special Trial License, you will need to send us a request along with some details indicating that you indeed have plans to purchase one or more full licenses.

Please note that only valid company/institution email addresses will be accepted. We cannot send Special Trial Licenses to free email accounts (like Hotmail, Yahoo, Gmail etc.)

A Special Trial License may be given for a period of 15 days.

Please, send your request to: contact@filigris.com or support@docflex.com

4.  Commercial License

Under this term, the Software provided by Filigris Works is licensed to a specific individual person or legal entity.

The Software is priced on a per-user basis and any license specifies the authorized number of users, the licensee name, organization and e-mail address.

Each Commercial License is a floating license. It means that the license may be installed on any number of computers and used by any number of people, provided that the number of concurrent users never exceeds the number of licensed users.

Restrictions

The DocFlex Software currently does not include any specific license manager that checks the number of concurrent users. You should ensure this by yourself so as to comply with your license. If you cannot control it you should buy more licenses (e.g. for each of the potential users)!

The Software (or any part of it) licensed under the Commercial License may not be redistributed separately or as a part of any other application. However, any output produced by the Software (including the template files created with it) may be freely distributed without limitations.

A Commercial License permits of using it to only a specific individual person, who purchased the license, or members of the licensee company/organization as a single legal entity.

The license may not be transferred to any other company/organization or individual, except the direct successor of the licensee who takes over the full legal rights and responsibility over the licensee business.

Delivery

The Software is only available through electronic delivery via Internet (see downloads). The fully functional version of the Software is unlocked by the license certificate sent to the user via e-mail to the specified e-mail address. By request, the license certificate may also be sent by post.

The license certificate represents a plain-text file with the information about the license and the licensee. The license file should be installed together with the Software according to the provided instruction.

Maintenance and Support

Each Commercial License includes the following maintenance and support:
  • Unlimited email support for a period of one year.

    The unlimited support means that you will normally get a reply on your e-mail during the same or the next working day, and we will keep corresponding with you until you have all your questions or problems fully resolved.

  • Free bugfix updates for the licensed version of the Software (see also below).

    If you report us a bug and provide with some information about how and where that bug is happening (in most cases, just a full Java Exception Stack Trace would suffice), normally, we can fix it and prepare an update during 2-3 following days. In fact, we have been very rarely reported about bugs, so that was experience from those few cases.

Upgrade Possibilities

For the owners of Commercial Licenses, we offer:
  • Free upgrades within the same generation (major version) of the licensed Software product. For example, if you purchase a license for the Software version 1.0, your license is automatically extended to versions 1.1, 1.5.1 and so on.

    To upgrade to a new version within the same generation, all you need to do is to download the new software from our web-site, install it, and install on it your license certificate. You don't need to tell or ask us about anything. Each new software version is designed and tested to support any early issued licenses covering it.

  • 40% discount for the upgrade to the next major version of the licensed product (e.g. 1.x.x -> 2.x.x)

Generated Output

The output documentation generated under Commercial License is free for any possible usage. In particular:
  • You may change the content of the generated files in any way you need, e.g. edit/remove some blocks, add your own, etc.
  • You are free to distribute your generated/modified documents with no limitations.
The text distortion, which you may see within the documents generated under the Trial License, will not appear once you have installed a Commercial License.

Templates

The Commercial License for the full edition of the given product line (which contains the Template Designer) allows you: The Commercial License for the reduced edition allows you:
Note:   To run a Commercial Template Application or any custom templates derived from it, an additional separate license for that application will be required.

For more information, please see Licensing of Templates section.

5.  Academic License

The Academic Licenses are available to students, faculty and staff of accredited academic institutions free of charge.

An Academic License permits you to use a fully functional version of the licensed Software for educational purposes only. In particular, that means you may not use it to make any commercial profit.

Other conditions are the same as for a Commercial License except the following:

  • Each Academic License may be given for a period of one year only. If you want to extend your license further, you will need to apply for a new Academic License next year.
  • Any discounts for non-free upgrades are not applicable.
  • Any templates created under an Academic License may not be executed with the freeware edition of the given product line. (However, they may be easily upgraded to that status once installing a Commercial License.)
To apply for an Academic License, you will need to send us a copy of a document that verifies your academic status or an URL to your listing on the institution's web-site.

Generated Output

The output documentation generated under the Academic License may be used for educational purposes only. Any commercial use is strictly prohibited!

The content of output files may be changed according to your needs.

The text distortion will not appear in the documentation generated under Academic License.

Templates

Any templates created/modified under the Academic License (for the full edition of the given product line) we shall call “academic templates”.

It is allowed to distribute academic templates to other people who also have an Academic or Commercial License for the same software, however, absolutely free of charge. (You may not make any profit from your Academic License!)

You may use your academic templates for commercial purposes, only after you have acquired the full Commercial License.

The academic templates will not work with any of the reduced editions of the given product line (e.g. DocFlex/XML RE or DocFlex/Doclet).

Note:   To remove that limitation (above), you should resave the templates after you have purchased and installed the full Commercial License.

The Academic License allows you to execute any custom templates created/modified (by you or someone else) under an Academic, Commercial or Trial License. However, any output files generated with such templates may be used only for educational purposes!

For further information, please see Licensing of Templates section.

6.  Licensing of Templates

Basic Templates

These are any templates developed by Filigris Works (and included in the provided software), which are not designated as “Commercial Template Applications”. In particular, this includes:
  • Any sample templates
  • The template applications, which implement some basic functionality essential for the entire product line. (For instance, such is the Basic Template Set currently provided with DocFlex/Javadoc.)
Using of Basic Templates does not require any specific licensing. You are equally free to modify such templates and base on them your own template applications (for more details, see Custom Templates).

Commercial Template Applications

“Commercial Template Applications” are big template sets developed by Filigris Works to implement certain general very complex tasks (for example, “DocFlex/XML XSDDoc” template set implements a high quality XML Schema Documentation Generator).

The Commercial Template Applications provide functionality which is typically offered by other companies in the form of separate commercial software products (or specific features of them).

Each Commercial Template Application, whatever complex the task it implements, is just a set of DocFlex templates. (A template is a plain-text file containing specific instructions for the template interpreter.) That means that anything the template application is able to generate is programmed entirely within the templates themselves. The template interpreter, the template language and its embedded functions provide only a general basic functionality needed for a particular application field (e.g. XML).

For example, DocFlex/XML by itself does not “know” anything about specific features you can see in the XML schema documentation generated with XSDDoc templates. Everything is programmed within the XSDDoc templates. (That means that when you need to change something in the output documentation, you just need to modify those templates. See Custom Templates for more details.)

Sometimes, implementing of a new big template application does require extending the general functionality of the base product. However, we always try to do this by introducing only very generic high-level new features suitable for lots of other possible tasks.

Since the DocFlex templates always require a special interpreter for their execution, all Commercial Template Applications are delivered as add-ins to each edition of the base product line. For example, the XSDDoc template set is included both in DocFlex/XML (Full Edition) and the reduced edition: DocFlex/XML RE.

On the other hand, because Commercial Template Applications actually solve some very complicated general tasks (something that other companies typically offer as separate commercial products), they require separate licensing.

Each Commercial Template Application has its own product name and version number. A license for it is attached to those attributes.

Commercial Template Applications may work under the following licenses:

  1. Limited Free License

    This license is activated by default when no other licenses have been found for the given Commercial Template Application. Under this license, you can run the template application only in limited mode. It means that some template parameters are disabled so as only their default values can be used. This, effectively, limits your ability to use certain features controlled by those parameters.

  2. Commercial License

    This license unlocks all parameters and main templates of the Commercial Template Application.

    You can use such a license with any edition of the main product (e.g. DocFlex/XML (Full Edition) or DocFlex/XML RE). You do not need to acquire any additional license covering the template interpreter/output generator itself and may work under its default Free or Limited Free License.

    A Commercial License for the given Template Application will allow you to use all the functionality implemented about the given application task (e.g. XML Schemas documentation generation). This will include all features both implemented in the templates themselves and supported by the template iterpretor / output generator (e.g. generation of RTF output with rendering of embedded HTML markup).

    See also Multiple Licenses.

  3. Academic License

    This license works the same as in the case of Commercial License.

  4. Trial License

    This license unlocks all functionality available under Commercial License, however it imposes specific limitations.

    See Trial License section for more details.

Custom Templates

Under this category, we consider any templates that have been created or modified the last time using the Template Designer (included in the full edition of the given product line) working under a Commercial or Academic License. This includes:
  1. Any templates developed completely by the users to solve their own specific tasks.

    The Commercial or Academic License imposes no specific limitations on possible usage of such templates. You may equally distribute them to anyone else.

  2. Any templates derived from the Basic Templates (i.e. produced by modification of the templates included in the basic template sets).

    You are also free to use/distribute such templates as you need.

  3. Any templates derived from the Commercial Template Applications.

    This is a special case. The idea of the licensing is the following. We have developed a template set (solving some specific complex task) and want a compensation for that particular work. However, you are allowed to add your own changes over that template set and any your extra work must be yours (we have no claims on it). How to fit all this together into a template set you will produce in the end?

    Here is how it works.

    A Commercial / Academic License for the main product that includes the Template Designer (e.g. DocFlex/XML SDK) will allow you to change the initial templates so much as you want. (You pay for a license for the main product to compensate for the whole DocFlex technology you use.)

    However, to execute your changed templates, a separate (not Limited Free) license covering the given (initial) Commercial Template Application will be required.

    Equally, you may distribute your modified templates to anyone else. However, only those people will be able to execute them, who have a Commercial / Academic or Trial License for the initial Commercial Template Application.

    Please, see also Multiple Licenses.

Those custom templates that have been modified the last time under a Commercial License may be also executed with a reduced edition of the given product line, which includes only the template interpreter/output generator (e.g. DocFlex/Doclet and DocFlex/XML RE).

Changing Templates Manually

In general, DocFlex templates should be edited using the Template Designer.

Although, the templates are actually plain-text files with the format looking somewhat similar to XML (see below), there are several reasons why we do not encourage changing templates manually. One of such reasons is that because of the licensing issues the template structure and content are locked with a special checksum. (This prevents easily forging the templates in order to circumvent licensing terms.)

However, when you need to quickly replace a certain string simultaneously in a number of template locations or translate lots of text labels into a different language, doing this by changing the templates in a simple text editor might be much faster.

The Commercial or Academic License allows you to do that. The following things can be changed in templates beyond the use of the Template Designer:

  • Text labels
  • FlexQuery expressions
  • Descriptions
  • Names of stock-sections and formatting styles
  • File pathnames of called subtemplates
Once you have changed anything mentioned above directly in the template source, the template checksum will be partially broken. However, when you work with the full edition under a Commercial or Academic License, that broken checksum will be ignored. You can execute such a template with the generator. When you resave the template using Template Designer, the correct checksum will be restored again.

Important:   If you change any other template settings manually (e.g. definitions of template components), the template checksum will be broken irreversibly. After that, it will be impossible to process anyhow such a template (including opening it with the Template Designer).

The same will happen if you spoil the template syntax!

Because of this, we strongly recommend to backup your templates before editing them manually!

About Template Format

First of all, the term templates may be somewhat misleading. What we call "templates" is actually a special kind of programs similar to XSL scripts (to which the DocFlex templates have a certain affinity).

However, unlike XSL (Extensible Stylesheet Language), which is a scripting language with rather rich expressive capabilities intended for human programmers but almost impossible to visualize, the DocFlex templates from the start have been designed to be edited using a graphic Template Designer, which would represent the templates more in the form of things we expect to see in the generated output rather than some abstract commands and operators. Such an approach requires that the Template Designer should pre-interpret some instructions contained in the templates and, up to a certain degree, show how the output they produce would look. This, in turn, implies that the template language must rely on rather simple and verbose constructions.

Currently, the DocFlex template language is still evolving. We constantly add new features and change some constructions. But we always make sure to support any legacy settings and functionality. Each template starts with the line like this:

<DOCFLEX_TEMPLATE VER='1.10'>

The version number allows recognizing what a template that is and how it must be treated. The template parser includes pieces of code that convert any legacy constructions into the new ones.

Although the template language looks somewhat similar to XML and even can be converted to XML entirely, currently, we do not plan to do this. The reasons are the following:

  • The template proprietary format makes it much easier to introduce new features and change the old ones (especially with respect to the necessary support of any legacy constructions).
  • Currently, we have ultra-fast template parser, which parses each template directly into a separate instance of the output generator. In effect, the template is treated as if it is a serialized sub-generator itself. (For more details on this topic, please see DocFlex Technology | What are Templates?) Turning to XML as the base template format will immediately add an extra layer of processing and slow it down.
  • Since the introduction of Commercial Template Applications (which embody substantial intellectual property), now licenses must be attached directly to the templates (rather than some binary executable code). Having the proprietary format helps with this.

So, moving templates on XML now would bring mostly aesthetic advantages rather than any practical ones. However, this does not mean we stuck with the proprietary format forever. When the right time comes, we will switch to XML definitely.

7.  Multiple Licenses

By its nature, DocFlex software can be described simultaneously in three different categories:
  1. A software development tool, which manifests itself as the Template Designer (and the template language it visualizes).
  2. A run-time environment, which is the template interpreter/output generator.
  3. Template applications that implement particular useful for everyone tasks (for example, “XML Schema Documentation Generator”).
Although, those pieces represent parts of the whole software system, essentially, they are intended for very different purposes. Therefore, not everyone needs all of them. Yet each of those parts cost great efforts to develop and cannot be given away totally free.

Breaking the software into different editions does not solve the problem completely, because this cannot cover all possible usage scenarios: either someone will have to pay for what they do not actually need or we are forced to give away valuable features without any compensation for them (and, therefore, will have little funds to develop them further).

The goal of this licensing system is to allow people to pay exactly for what they are willing to use and to remain the integrity of the whole software at the same time. This goal can be achived by introducing multiple licenses. Here is how it works.

A particular software package is always the same and may include lots of functionality. Without the proper licenses that functionality works only in a reduced or demo mode (see Limited Free License). When you want to use some specific features you buy a Commercial License that covers them. If you need another set of features, then you just buy another license. Both (or more) licenses can be installed together. As a result, you get a software that does what you need and pay only for what you use.

Example

An employee named Joan of some imagined company called PerfectSoft Ltd. needed a good XML Schema documentation generator for her job task. She found one called “DocFlex/XML XSDDoc” at this website. It happened to be a set of templates included in a software package “DocFlex/XML RE”. When Joan downloaded that software and investigated it, she realized that this was exactly what she needed.

Joan learnt that if she purchased a Commercial License for DocFlex/XML XSDDoc and used the default Free License for the template interpreter/output generator included in the DocFlex/XML RE, she would be able to generate a complete framed HTML (Javadoc-like) XML schema documentation she needed right then. Joan asked her company to buy a license for DocFlex/XML XSDDoc.

Some months later, Joan had another task. Now, she needed to prepare some printable manual, which would include a description of some XML schema. It would be great to have that description generated automatically in RTF format because Joan could join it with other her texts using MS Word. But the default RTF produced by XSDDoc was not suitable for her because it did not comply with the manual's style and organization. Joan knew that she could change everything in the generated output by customizing the standard XSDDoc templates using the Template Designer included in DocFlex/XML SDK. She asked her company to purchase a license for that product as well. When Joan installed it along with her old license for XSDDoc, started the template designer and invoked the “About” dialog, she saw the following screen:

Multiple Licenses - Example

Restrictions

In the example above, we discussed a situation when the output documentation could be generated simultaneously under two licenses:
  1. A license for “DocFlex/XML XSDDoc” template application.
  2. A license for “DocFlex/XML SDK”, which covers the template designer and generator.
Both of those licenses were Commercial Licenses.

But, what if the licenses have different types? For instance, the first is a Commercial License and the second is a Trial License? (After all, before buying a commercial license for DocFlex/XML SDK, Joan might want to try it first!)

In that case, a question arises:

If licenses of different types impose different restrictions on the generated output, which of those restrictions apply to the generated documentation?
The answer is following:
When to unlock all necessary features of the DocFlex software several specific (not Limited Free) licenses are installed and some of those licenses have different types, the license that imposes maximum restrictions and obligations will have the highest priority.

For example, when some output has been generated simultaneously under both Commercial and Trial Licenses, that will be considered the “trial output” with all restrictions implied from this (see Trial License | Generated Output).

The following table shows all matching license types and their priorities:

License Type Priority
Trial License 4
Academic License 3
Commercial License 2
Limited Free License 1

8.  Getting Help

If you have any questions concerning licensing or pricing of DocFlex software, please, do not hesitate to let us know by sending an email to: contact@filigris.com or support@docflex.com

Copyright© 2003-2014 Filigris Works, Leonid Rudy Softwareprodukte. All rights reserved.