qulogic/libgnt

Add README and ChangeLogs.

2019-04-11, Elliott Sales de Andrade
562266997a96
Parents 9c8fc70af8eb
Children 301b56eb7f34
Add README and ChangeLogs.
3 files changed, 613 insertions(+), 0 deletions(-)
  • +226 -0
    ChangeLog
  • +268 -0
    ChangeLog.API
  • +119 -0
    README.md
    • --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/ChangeLog Thu Apr 11 19:28:00 2019 -0400
    @@ -0,0 +1,226 @@
    +GNT: The GLib Ncurses Toolkit
    +=============================
    +
    +Please see notes about versioning in README.md.
    +
    +version 3.0.0 (????/??/??):
    + * Fix a use after free when using Python. (PR #357 kdex)
    +
    +version 2.13.0 (2018/03/08):
    + * Fixed build against curses 6.0 with opaque structs set. (#16764 dimstar)
    + (PR #268 Daniel Kamil Kozar)
    + * Fixed a crash when resizing the window. (#16680 marcus) (PR #269 Daniel Kamil Kozar)
    +
    +version 2.12.0 (2017/03/09):
    + No changes.
    +
    +version 2.11.0 (2016/06/21):
    + No changes.
    +
    +version 2.10.12 (2015/12/31):
    + No changes.
    +
    +version 2.10.11 (2014/11/23):
    + No changes.
    +
    +version 2.10.10 (2014/10/22):
    + * Fix build against Python 3. (Ed Catmur) (#15969)
    +
    +version 2.10.9 (2014/02/02):
    + No changes.
    +
    +version 2.10.8 (2014/01/28):
    + No changes.
    +
    +version 2.10.7 (2013/02/13):
    + Alien hatchery:
    + * No changes
    +
    +version 2.10.6 (2012/07/06):
    + No changes.
    +
    +version 2.10.5 (2012/07/05):
    + No changes.
    +
    +version 2.10.4 (2012/05/06):
    + No changes.
    +
    +version 2.10.3 (2012/03/26):
    + No changes.
    +
    +version 2.10.2 (2012/03/14):
    + No changes.
    +
    +version 2.10.1 (2011/12/06):
    + * Fix compilation on OpenBSD.
    +
    +version 2.10.0 (2011/08/18):
    + No changes.
    +
    +version 2.9.0 (2011/06/23):
    + No changes.
    +
    +version 2.8.0 (2011/06/07):
    + No changes.
    +
    +version 2.7.11 (2011/03/10):
    + No changes.
    +
    +version 2.7.10 (2011/02/06):
    + No changes.
    +
    +version 2.7.9 (2010/12/26):
    + No changes.
    +
    +version 2.7.8 (2010/12/19):
    + No changes.
    +
    +version 2.7.7 (2010/11/23):
    + No changes.
    +
    +version 2.7.6 (2010/11/21):
    + No changes.
    +
    +version 2.7.5 (2010/10/31):
    + No changes.
    +
    +version 2.7.4 (2010/10/20):
    + No changes.
    +
    +version 2.7.3 (2010/08/10):
    + * Rebindable 'suggest-next-page' and 'suggest-prev-page' actions for
    + textboxes (GntEntry) to scroll through list of suggestions.
    + * Rebindable 'dropdown' action for comboboxes (GntComboBox) to show the
    + dropdown list of options.
    +
    +version 2.7.2 (2010/07/21):
    + No changes.
    +
    +version 2.7.1 (2010/05/29):
    + No changes.
    +
    +version 2.7.0 (2010/05/12):
    + * Changed GLib minimum version requirement to 2.12.0.
    + * Fix autoconf detection of Python. (Brad Smith)
    + * New action 'history-search', with default binding ctrl+r, to search
    + the entered string in the input history.
    +
    +version 2.6.6 (2010/02/18):
    + * Fix CVE-2010-0420, a possible remote crash when handling chat room
    + buddy names.
    + * Rebindable 'move-first' and 'move-last' actions for tree widgets. So
    + it is possible to jump to the first or last entry in the buddy list
    + (and other such lists) by pressing home or end key (defaults)
    + respectively.
    +
    +version 2.6.5 (2010/01/08):
    + * Build-time fixes for Solaris. (Paul Townsend)
    +
    +version 2.6.4 (2009/11/29):
    + * Fix displaying umlauts etc. in non-utf8 locale.
    +
    +version 2.6.3 (2009/10/16):
    + No changes.
    +
    +version 2.6.2 (2009/09/05):
    + * Properly detect libpanel on OpenBSD. (Brad Smith)
    + * Remove IO watches in gnt_quit. (Tomasz Mon)
    +
    +version 2.6.1 (2009/08/18):
    + No changes.
    +
    +version 2.6.0 (2009/08/18):
    + * The hardware cursor is updated correctly. This will be useful
    + especially for users of braille terminals, screen readers etc.
    + * Fixed UTF-8 compatibility problems which could cause exits or other
    + unrequested behaviour.
    + * Add a new progress bar widget. (Saleem Abdulrasool)
    +
    +version 2.5.9 (2009/08/18):
    + No changes.
    +
    +version 2.5.8 (2009/06/27):
    + No changes.
    +
    +version 2.5.7 (2009/06/20):
    + No changes.
    +
    +version 2.5.6 (2009/05/19):
    + No changes.
    +
    +version 2.5.5 (2009/03/01):
    + * Allow rebinding keys to change the focused widget (details in the
    + man-page, look for GntBox::binding)
    +
    +version 2.5.4 (2009/01/12):
    + * Fix rebinding actions with the arrow-keys and tab.
    +
    +version 2.5.3 (2008/12/20):
    + * Allow binding meta+arrow keys for actions.
    + * Added default meta+erase binding for delete previous word.
    +
    +version 2.5.2 (2008/10/19):
    + * A bug was fixed where some key-bindings wouldn't work with some TERMs
    + (e.g. xterm-color, screen-linux etc.)
    +
    +version 2.5.1 (2008/08/30):
    + No changes.
    +
    +version 2.5.0 (2008/08/18):
    + No changes.
    +
    +version 2.4.2 (2008/05/17):
    + * New default binding ctrl+x to open context menus.
    + * Menu triggers and other bindings will no longer conflict.
    + * Middle click pastes the internal clipboard (when mouse support is
    + enabled).
    +
    +version 2.4.1 (2008/03/31):
    + * Fix compiling with Glib older than 2.6
    +
    +version 2.4.0 (2008/02/29):
    + * The default keybinding for dump-screen is now M-D and uses a file
    + request dialog. M-d will properly delete-forward-word, and M-f has been
    + fixed to imitate readline's behavior.
    + * New bindings alt+tab and alt+shift+tab to help navigating between the
    + higlighted windows (details on the man page).
    +
    +version 2.3.0 (2007/11/24):
    + * It's possible to bind key-strokes to specific menuitems in the windows.
    + Read the 'Menus' section in the man-page for details.
    + * 'transpose-chars' operation for the entry boxes. The default key-binding
    + is ctrl+t.
    + * 'yank' operation for the entry boxes. The default binding is ctrl+y.
    +
    +version 2.2.2 (2007/10/23):
    + * Various bug and memory leak fixes
    +
    +version 2.2.1 (2007/09/29):
    + No changes.
    +
    +version 2.2.0 (2007/09/13):
    + No changes.
    +
    +version 2.1.1 (2007/08/20):
    + No changes.
    +
    +version 2.1.0 (2007/07/28):
    + * There's support for workspaces now (details in the manpage)
    + * There's a new custom window manager, Irssi
    + * Some improvements for tab-completion, tooltip and the password entries
    + * Some bugs regarding search results fixed
    +
    +version 2.0.2 (2007/06/14):
    + No changes.
    +
    +version 2.0.1 (2007/05/24):
    + * Improved tab completion support
    + * Ctrl+c prompts with a dialog before exiting
    + * Work around an ncurses bug which appears when half of a multi-cell
    + character is covered by an upper-level window
    + * Nicer HTML screendumps
    +
    +version 2.0.0 (2007/05/03):
    + Build Changes:
    + * A new ncurses-based console UI called Finch is now available
    + (Sadrul Habib Chowdhury, Google Summer of Code)
    --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/ChangeLog.API Thu Apr 11 19:28:00 2019 -0400
    @@ -0,0 +1,268 @@
    +GNT: The GLib Ncurses Toolkit
    +=============================
    +
    +Please see notes about versioning in README.md.
    +
    +This file intends to list all changes to libgnt's public API. We sometimes
    +forget to add changes to this file--sorry.
    +
    +If your plugin fails to build with a new major version (e.g. 3.0.0) we suggest
    +checking this list first, in case a function was simply renamed.
    +You may still need to consult our API docs or our source code.
    +
    +If you notice something missing from this list, please let us know and we'll
    +add it.
    +
    +version 3.0.0 (????/??/??):
    + Changed:
    + * ENTRY_CHAR renamed to GNT_ENTRY_CHAR
    + * g_hash_table_duplicate renamed to gnt_hash_table_duplicate
    + * GDupFunc renamed to GntDuplicateFunc
    +
    + Removed:
    + * _GntFileType
    + * _GntKeyPressMode
    + * _GntMouseEvent
    + * _GntParamFlags
    + * _GntProgressBarOrientation
    + * _GntTreeColumnFlag
    + * _GntWidgetFlags
    +
    +version 2.13.0 (2018/03/08):
    + No changes.
    +
    +version 2.12.0 (2017/03/09):
    + No changes.
    +
    +version 2.11.0 (2016/06/21):
    + No changes.
    +
    +version 2.10.12 (2015/12/31):
    + No changes.
    +
    +version 2.10.11 (2014/11/23):
    + No changes.
    +
    +version 2.10.10 (2014/10/22):
    + No changes.
    +
    +version 2.10.9 (2014/02/02):
    + No changes.
    +
    +version 2.10.8 (2014/01/28):
    + No changes.
    +
    +version 2.10.7 (2013/02/13):
    + No changes.
    +
    +version 2.10.6 (2012/07/06):
    + No changes.
    +
    +version 2.10.5 (2012/07/05):
    + No changes.
    +
    +version 2.10.4 (2012/05/06):
    + No changes.
    +
    +version 2.10.3 (2012/03/26):
    + No changes.
    +
    +version 2.10.2 (2012/03/14):
    + No changes.
    +
    +version 2.10.1 (2011/12/06):
    + No changes.
    +
    +version 2.10.0 (2011/08/18):
    + No changes.
    +
    +version 2.9.0 (2011/06/23):
    + No changes.
    +
    +version 2.8.0 (2011/06/07):
    + No changes.
    +
    +version 2.7.11 (2011/03/10):
    + No changes.
    +
    +version 2.7.10 (2011/02/06):
    + No changes.
    +
    +version 2.7.9 (2010/12/26):
    + No changes.
    +
    +version 2.7.8 (2010/12/19):
    + No changes.
    +
    +version 2.7.7 (2010/11/23):
    + No changes.
    +
    +version 2.7.6 (2010/11/21):
    + No changes.
    +
    +version 2.7.5 (2010/10/31):
    + No changes.
    +
    +version 2.7.4 (2010/10/20):
    + No changes.
    +
    +version 2.7.3 (2010/08/10):
    + Added:
    + * gnt_tree_row_get_child
    + * gnt_tree_row_get_key
    + * gnt_tree_row_get_next
    + * gnt_tree_row_get_parent
    + * gnt_tree_row_get_prev
    +
    +version 2.7.2 (2010/07/21):
    + No changes.
    +
    +version 2.7.1 (2010/05/29):
    + No changes.
    +
    +version 2.7.0 (2010/05/12):
    + Added:
    + * GntEntrySearch *search; member to GntEntry
    +
    +version 2.6.6 (2010/02/18):
    + No changes.
    +
    +version 2.6.5 (2010/01/08):
    + No changes.
    +
    +version 2.6.4 (2009/11/29):
    + No changes.
    +
    +version 2.6.3 (2009/10/16):
    + No changes.
    +
    +version 2.6.2 (2009/09/05):
    + No changes.
    +
    +version 2.6.1 (2009/08/18):
    + No changes.
    +
    +version 2.6.0 (2009/08/18):
    + Added:
    + * GntProgressBar and functions (Saleem Abdulrasool)
    +
    +version 2.5.9 (2009/08/18):
    + No changes.
    +
    +version 2.5.8 (2009/06/27):
    + No changes.
    +
    +version 2.5.7 (2009/06/20):
    + No changes.
    +
    +version 2.5.6 (2009/05/19):
    + No changes.
    +
    +version 2.5.5 (2009/03/01):
    + No changes.
    +
    +version 2.5.4 (2009/01/12):
    + No changes.
    +
    +version 2.5.3 (2008/12/20):
    + No changes.
    +
    +version 2.5.2 (2008/10/19):
    + No changes.
    +
    +version 2.5.1 (2008/08/30):
    + No changes.
    +
    +version 2.5.0 (2008/08/18):
    + No changes.
    +
    +version 2.4.2 (2008/05/17):
    + Added:
    + * gnt_bindable_check_key to check if a keystroke is bound.
    +
    +version 2.4.1 (2008/03/31):
    + No changes.
    +
    +version 2.4.0 (2008/02/29):
    + Added:
    + * gnt_tree_set_row_color to set the color for a row in a tree.
    + * gnt_style_get_string_list
    + * gnt_color_add_pair to define a new color.
    + * gnt_colors_get_color to get an ncurses color value from a string.
    + * gnt_style_get_color to get a color pair from an entry in ~/.gntrc
    + * gnt_tree_get_parent_key to get the key for the parent row.
    +
    +version 2.3.0 (2007/11/24):
    + Added:
    + * gnt_color_pair, which will try to intelligenty set text attributes
    + in place of colors if the terminal doesn't have color support. (Bug:
    + #3560) All future code should use gnt_color_pair instead of
    + COLOR_PAIR.
    + * gnt_menuitem_set_id and gnt_menuitem_get_id to set and get the
    + string id of a menuitem respectively.
    + * gnt_window_get_accel_item, which returns a the id of a menuitem
    + bound to a keystroke.
    + * gnt_menu_get_item to get a menuitem of the given id from a menu.
    + * gnt_menuitem_activate, which triggers the 'activate' signal on the
    + menuitem and calls the callback function, if available.
    + * GntEntryKillRing in GntEntry.
    + * gnt_window_set_maximize and gnt_window_get_maximize, and
    + GntWindowFlags enum.
    +
    +version 2.2.2 (2007/10/23):
    + No changes.
    +
    +version 2.2.1 (2007/09/29):
    + No changes.
    +
    +version 2.2.0 (2007/09/13):
    + Added:
    + * gnt_slider_set_small_step, gnt_slider_set_large_step to allow more
    + fine tuned updates of a GntSlider
    + * gnt_util_parse_xhtml_to_textview to parse XHTML strings in a
    + GntTextView (this works only if libxml2 is available)
    +
    +version 2.1.1 (2007/08/20):
    + Added:
    + * gnt_bindable_bindings_view
    + * gnt_bindable_build_help_window
    + * GNT_TEXT_VIEW_TOP_ALIGN
    +
    +version 2.1.0 (2007/07/28):
    + Added:
    + * GntWS for workspaces
    + * gnt_tree_set_column_title
    + * GntSlider widget
    + * "completion" signal for GntEntry
    + * "terminal-refresh" signal for GntWM, with a corresponding entry in
    + GntWMClass
    + * New flags for GntTextView to decide whether to word-wrap or show
    + scrollbars (GntTextViewFlag) which can be set by
    + gnt_text_view_set_flag
    + * gnt_style_get_from_name
    + * gnt_window_present
    + * gnt_tree_set_column_width_ratio
    + * gnt_tree_set_column_resizable
    + * gnt_tree_set_column_is_right_aligned
    + * gnt_tree_set_search_function
    + * gnt_tree_set_search_column
    + * gnt_tree_is_searching
    + * 'file-selected' signal is emitted for GntFileSel
    + * gnt_style_parse_bool
    + * gnt_util_set_trigger_widget
    +
    + Changed:
    + * gnt_tree_get_rows() now returns a GList* instead of a const GList*,
    + as const is not very useful with GLists. The returned value still
    + must not be modified or freed.
    + * Instead of keeping an 'invisible' item, the GntTreeColumns now
    + maintain 'flags' with the appropriate flags set
    +
    +version 2.0.2 (2007/06/14):
    + No changes.
    +
    +version 2.0.1 (2007/05/24):
    + No changes.
    +
    +version 2.0.0 (2007/05/03):
    + Initial release.
    --- /dev/null Thu Jan 01 00:00:00 1970 +0000
    +++ b/README.md Thu Apr 11 19:28:00 2019 -0400
    @@ -0,0 +1,119 @@
    +GNT: The GLib Ncurses Toolkit
    +=============================
    +
    +GNT is an ncurses toolkit for creating text-mode graphical user interfaces in a
    +fast and easy way. It is based on [GLib](https://wiki.gnome.org/Projects/GLib)
    +and [ncurses](https://www.gnu.org/software/ncurses/ncurses.html).
    +
    +It was born out of the console-based UI, **Finch**, for the [libpurple
    +project](https://developer.pidgin.im/wiki/WhatIsLibpurple), but has now been
    +split into its own independent repository.
    +
    +Building GNT
    +------------
    +
    +To build, you will need [Meson](https://mesonbuild.com/),
    +[GLib](https://wiki.gnome.org/Projects/GLib),
    +[ncurses](https://www.gnu.org/software/ncurses/ncurses.html),
    +[libxml2](http://xmlsoft.org/), and [Python 3](https://www.python.org/). Exact
    +versions can be determined from the `meson.build` in the top-level directory.
    +
    +On Debian-based systems, install `meson` `ninja-build` `gobject-introspection`
    +`libgirepository1.0-dev` `gtk-doc-tools` `libglib2.0-dev` `libxml2-dev`
    +`libncurses-dev` `libpython3-dev`.
    +
    +On Fedora-based systems, install `meson` `ninja-build` `gobject-introspection`
    +`gtk-doc` `glib2-devel` `libxml2-devel` `ncurses-devel` `python3-devel`.
    +
    +You can then run Meson and Ninja as usual (passing any `-D` options if necessary):
    +
    +```bash
    +$ meson build
    +$ ninja -C build
    +$ ninja -C build install
    +```
    +
    +Notes About Versioning
    +----------------------
    +
    +This code was originally contained in the Pidgin/Finch/libpurple repository.
    +Versions were set by the top-level `configure.ac` in that repository. The GNT
    +version was independent of Pidgin and Finch and the tag. This repository
    +contains the original tags and so you may see multiple tags pointing to the
    +same commit. The GNT version *as it was released* is noted in the second column
    +of the table below.
    +
    +A second `configure.ac` was included in the `libgnt` subdirectory that was
    +extracted to produce this repository. Unfortunately, we were not consistent
    +with updating the version in that copy. It was deemed too much work for little
    +gain to go back through the history to correct this error when producing this
    +split repository. As such, the third column of the table below contains the
    +version *as recorded in `configure.ac`* at the time of a tag.
    +
    +Beginning with version 2.14.0, the code has been moved to a separate repository
    +and so the tag and the version will remain in sync.
    +
    +Tagged | Released | Recorded
    +-------- | ---------- | ----------
    +v2.13.0 | 2.8.10 | 2.8.0devel
    +v2.12.0 | 2.8.10 | 2.8.0devel
    +v2.11.0 | 2.8.10 | 2.8.0devel
    +v2.10.12 | 2.8.10 | 2.8.0devel
    +v2.10.11 | 2.8.10 | 2.8.0devel
    +v2.10.10 | 2.8.10 | 2.8.0devel
    +v2.10.9 | 2.8.10 | 2.8.0devel
    +v2.10.8 | 2.8.10 | 2.8.0devel
    +v2.10.7 | 2.8.9 | 2.8.0devel
    +v2.10.6 | 2.8.9 | 2.8.0devel
    +v2.10.5 | 2.8.9 | 2.8.0devel
    +v2.10.4 | 2.8.9devel | 2.8.0devel
    +v2.10.3 | 2.8.9 | 2.8.0devel
    +v2.10.2 | 2.8.9 | 2.8.0devel
    +v2.10.1 | 2.8.9 | 2.8.0devel
    +v2.10.0 | 2.8.9 | 2.8.0devel
    +v2.9.0 | 2.8.9 | 2.8.0devel
    +v2.8.0 | 2.8.8 | 2.8.0devel
    +v2.7.11 | 2.8.7 | 2.8.0devel
    +v2.7.10 | 2.8.6 | 2.8.0devel
    +v2.7.9 | 2.8.5 | 2.8.0devel
    +v2.7.8 | 2.8.5 | 2.8.0devel
    +v2.7.7 | 2.8.4 | 2.8.0devel
    +v2.7.6 | 2.8.3 | 2.8.0devel
    +v2.7.5 | 2.8.2 | 2.8.0devel
    +v2.7.4 | 2.8.1 | 2.8.0devel
    +v2.7.3 | 2.8.0 | 2.8.0devel
    +v2.7.2 | 2.7.2 | 2.7.0devel
    +v2.7.1 | 2.7.1 | 2.7.0devel
    +v2.7.0 | 2.7.0 | 2.7.0devel
    +v2.6.6 | 2.6.6 | 2.6.2devel
    +v2.6.5 | 2.6.5 | 2.6.2devel
    +v2.6.4 | 2.6.4 | 2.6.2devel
    +v2.6.3 | 2.6.3 | 2.6.2devel
    +v2.6.2 | 2.6.2 | 2.6.2devel
    +v2.6.1 | 2.6.1 | 2.5.0
    +v2.6.0 | 2.6.0 | 2.5.0
    +v2.5.9 | 2.5.9 | 2.5.6
    +v2.5.8 | 2.5.8 | 2.5.6
    +v2.5.7 | 2.5.7 | 2.5.6
    +v2.5.6 | 2.5.6 | 2.5.6
    +v2.5.5 | 2.5.5 | 2.5.0
    +v2.5.4 | 2.5.4 | 2.5.0
    +v2.5.3a | 2.5.3 | 2.5.0
    +v2.5.3 | 2.5.3devel | 2.5.0
    +v2.5.2 | 2.5.2 | 2.5.0
    +v2.5.1 | 2.5.1 | 2.5.0
    +v2.5.0 | 2.5.0 | 2.5.0
    +v2.4.3 | 2.4.3 | 2.4.2
    +v2.4.2 | 2.4.2 | 2.4.2
    +v2.4.1 | 2.4.1 | 2.4.1
    +v2.4.0 | 2.4.0 | 2.4.0devel
    +v2.3.1 | 2.3.1 | 2.3.1
    +v2.3.0 | 2.3.0 | 2.3.0
    +v2.2.2 | 2.2.2 | 2.2.0devel
    +v2.2.1 | 2.2.1 | 2.2.0devel
    +v2.2.0 | 2.2.0 | 2.2.0devel
    +v2.1.1 | 2.1.0 | 2.1.0devel
    +v2.1.0 | 2.0.0 | 2.0.0devel
    +v2.0.2 | 1.0.2 | 1.0.0beta7
    +v2.0.1 | 1.0.1 | 1.0.0beta7
    +v2.0.0 | 1.0.0 | 1.0.0beta7