https://github.com/gnome/devhelp

Read-only mirror of https://gitlab.gnome.org/GNOME/devhelp
https://github.com/gnome/devhelp

Last synced: about 1 month ago
JSON representation

Read-only mirror of https://gitlab.gnome.org/GNOME/devhelp

• Host: GitHub
• URL: https://github.com/gnome/devhelp
• Owner: GNOME
• Created: 2012-06-03T04:55:13.000Z (over 12 years ago)
• Default Branch: main
• Last Pushed: 2024-09-14T13:49:44.000Z (2 months ago)
• Last Synced: 2024-10-07T12:50:16.343Z (about 1 month ago)
• Language: C
• Homepage: https://gitlab.gnome.org/GNOME/devhelp
• Size: 9.9 MB
• Stars: 32
• Watchers: 10
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS
  • Contributing: CONTRIBUTING.md
  • License: LICENSES/CC-BY-SA-4.0.txt

Awesome Lists containing this project

README

        
Devhelp

=======

Description

-----------

Devhelp is a developer tool for browsing and searching API documentation.

It provides an easy way to navigate through libraries and to search by

function, struct, or macro.

The documentation must be installed locally, so an internet connection is

not needed to use Devhelp.

Devhelp works natively with the documentation generators used by the GNOME

project libraries. Other development platforms can be supported as well, as

long as the API documentation is available in HTML and a `*.devhelp2` index

file is generated.

Devhelp integrates with other applications such as Glade, Builder or

Anjuta, and plugins are available for different text editors (gedit, Vim,

Emacs, Geany, …).

Installation of the Devhelp Flatpak

-----------------------------------

- [Devhelp on Flathub](https://flathub.org/apps/details/org.gnome.Devhelp)

How to contribute

-----------------

See the [contribution guide](CONTRIBUTING.md).

Dependencies

------------

- GLib

- GTK

- WebKitGTK

- gsettings-desktop-schemas

Integration with other developer tools

--------------------------------------

Devhelp provides some command line options, such as `--search` and

`--search-assistant`. A text editor plugin can for example launch the command

`devhelp --search function_name` when a keyboard shortcut is pressed, with the

`function_name` under the cursor.

Devhelp also provides a shared library, to integrate the GTK widgets inside an

IDE. It is used for example by Builder and Anjuta.

For the `--search` command line option, see the class description of

`DhKeywordModel`, the search string supports additional features useful for IDEs

or other developer tools.

Other documentation

-------------------

- There is user documentation written in the Mallard format in the `help/C/`

  directory. You can open that documentation with the `yelp help/C/` command,

  or pressing F1 in the Devhelp application.

- There is an API reference manual for the libdevhelp that can be built with

  GTK-Doc, see the `gtk_doc` build option.

Default development branch

--------------------------

The default development branch of Devhelp has been renamed to `main`. If you

have just cloned the Devhelp repository, you don't need to change anything.

If you have an older local checkout, you can use these commands to switch

from the old default branch name to the new one:

```

git switch master

git branch -m master main

git fetch

git branch --unset-upstream

git branch -u origin/main

git symbolic-ref refs/remotes/origin/HEAD refs/remotes/origin/main

```