# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-gi-docgen
VERSION=		2023.3
KEYWORDS=		python
VARIANTS=		v11 v12
SDESC[v11]=		Documentation tool for GObject-based libs (3.11)
SDESC[v12]=		Documentation tool for GObject-based libs (3.12)
HOMEPAGE=		https://gitlab.gnome.org/GNOME/gi-docgen
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/9a/9a/1221564e13c97af17ebf55da41267799b630d0258530152a75feffe99eec
DISTFILE[1]=		gi_docgen-2023.3-py2.py3-none-any.whl:main
DF_INDEX=		1
SPKGS[v11]=		complete
			primary
			dev
SPKGS[v12]=		complete
			primary
			dev

OPTIONS_AVAILABLE=	PY311 PY312
OPTIONS_STANDARD=	none
VOPTS[v11]=		PY311=ON PY312=OFF
VOPTS[v12]=		PY311=OFF PY312=ON

DISTNAME=		gi_docgen-2023.3.dist-info

GENERATED=		yes

[PY311].RUN_DEPENDS_ON=			python-Markdown:single:v11
					python-MarkupSafe:single:v11
					python-Pygments:single:v11
					python-Jinja2:single:v11
					python-packaging:single:v11
					python-typogrify:single:v11
[PY311].USES_ON=			python:v11,wheel

[PY312].RUN_DEPENDS_ON=			python-Markdown:single:v12
					python-MarkupSafe:single:v12
					python-Pygments:single:v12
					python-Jinja2:single:v12
					python-packaging:single:v12
					python-typogrify:single:v12
[PY312].USES_ON=			python:v12,wheel

post-install:
	${MV} ${STAGEDIR}${PREFIX}/share/pkgconfig/gi-docgen.pc ${STAGEDIR}${PREFIX}/lib/pkgconfig/gi-docgen.pc
	${RMDIR} ${STAGEDIR}${PREFIX}/share/pkgconfig
	${REINPLACE_CMD} 's!/usr/share:!/${PREFIX}/share:/usr/share:!' ${STAGEDIR}${PREFIX}/lib/python${PYTHON_VER}/site-packages/gidocgen/utils.py

[FILE:2334:descriptions/desc.primary]
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
```

## Usage

First, read [the GI-DocGen tutorial].

The documentation for GI-DocGen is [available online].

The `examples` directory in the repository contains simple project files
for
various GNOME libraries.

## Disclaimer

GI-DocGen is **not** a general purpose documentation tool for C libraries.

While GI-DocGen can be used to generate API references for most GObject/C
libraries that expose introspection data, its main goal is to generate the
reference for GTK and its immediate dependencies. Any and all attempts at
making this tool more generic, or to cover more use cases, will be weighted
heavily against its primary goal.

GI-DocGen is still in development. The recommended use of GI-DocGen is to
add it as a sub-project to your [Meson build system],
and vendor it when releasing dist archives.

You should **not** depend on a system-wide installation until GI-DocGen is
declared stable.

If you need a general purpose documentation tool, I strongly recommend:

 - [HotDoc]
 - [Doxygen]
 - [GTK-Doc]

## 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 Public License, either version 3.0 or,
at your option, any later version.


[FILE:116:distinfo]
4375f2e35fdb6fef6dfe7026ede1077fd515a9ca72adc5555db291428a101310      1260856 gi_docgen-2023.3-py2.py3-none-any.whl