Metadata-Version: 2.1
Name: gi-docgen
Version: 2021.2
Summary: Documentation tool for GObject-based libraries
Home-page: https://gitlab.gnome.org/ebassi/gi-docgen
Author: Emmanuele Bassi
Author-email: ebassi@gnome.org
License: GPL-3.0-or-later AND Apache-2.0 AND CC0-1.0
Project-URL: Bug tracker, https://gitlab.gnome.org/ebassi/gi-docgen/issues
Project-URL: Documentation, https://ebassi.gitlab.gnome.org/gi-docgen/
Description: <!--
        SPDX-FileCopyrightText: 2021 GNOME Foundation
        
        SPDX-License-Identifier: Apache-2.0 OR GPL-3.0-or-later
        -->
        
        GI-DocGen: Documentation tool for GObject-based libraries
        -------------------------------------------------------------------------------
        
        GI-DocGen is a document generator for GObject-based libraries. GObject is
        the base type system of the GNOME project. GI-Docgen reuses the
        introspection data generated by GObject-based libraries to generate the API
        reference of these libraries, as well as other ancillary documentation.
        
        ## Installation
        
        ### Running GI-DocGen uninstalled
        
        You can run GI-DocGen from its repository, by calling:
        
        ```
        ./gi-docgen.py
        ```
        
        GI-DocGen will automatically detect this case.
        
        ### Installing GI-DocGen via pip
        
        To install GI-DocGen, you will need to have the following pieces of software
        available on your computer:
        
         - Python 3.6, or later
         - pip
        
        Run the following command:
        
        ```
        pip3 install --user gi-docgen
        ```
        
        After running the command above, make sure to have the `~/.local/bin`
        directory listed in your `$PATH` environment variable.
        
        To update GI-DocGen, run the following command:
        
        ```
        pip3 install --user --upgrade gi-docgen
        ```
        
        ### Installing GI-DocGen from source
        
        You can also install GI-DocGen from a local copy of its source code
        repository, but we recommend the methods above for easier and more stable
        updates. Please make sure the requirements for the installation via pip are
        present on your machine. Once you are inside the source code directory,
        run the following command:
        
        ```
        python3 setup.py install
        ```
        
        ## Usage
        
        First, read [the GI-DocGen tutorial](https://ebassi.pages.gitlab.gnome.org/gi-docgen/tutorial.html).
        
        The documentation for GI-DocGen is [available online](https://ebassi.pages.gitlab.gnome.org/gi-docgen/).
        
        The `examples` directory in the repository contains simple project files for
        various GNOME libraries.
        
        ## Copyright and Licensing terms
        
        Copyright 2021  GNOME Foundation
        
        GI-DocGen is released under the terms of the Apache License, version 2.0, or
        under the terms of the GNU General Publice License, either version 3.0 or,
        at your option, any later version.
        
Keywords: documentation,introspection,gobject,gtk
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Desktop Environment :: Gnome
Classifier: Topic :: Software Development :: Documentation
Requires-Python: >=3.6.0
Description-Content-Type: text/markdown
Provides-Extra: test
