Browse Source

Add help-browser.py

K. Lange 1 year ago
parent
commit
13cbcec3ff

+ 1 - 0
.gitignore

@@ -28,6 +28,7 @@
 /base/usr/bin/*
 /base/usr/lib/*
 /base/usr/share/python-demos
+/base/usr/share/help
 
 # Generic
 /base/usr/share/aclocal

+ 34 - 0
util/extra-help/0_index.trt

@@ -0,0 +1,34 @@
+
+<h1>Welcome to ToaruOS!</h1>
+
+<img src="/usr/share/logo_login.png"></img>
+とあるOS (ToaruOS) is a hobby operating system built mostly from scratch, including both a kernel and userspace.
+
+<h2>Introduction</h2>
+
+This <link target="help_browser.trt"><i>Help Browser</i></link> is intended to provide guidance and assistance in using ToaruOS.
+
+For a listing of topics, see the <link target="special:contents">Table of Contents</link>.
+
+<h2>History</h2>
+
+ToaruOS started as a side project at the University of Illinois at Urbana-Champaign. For several months in late 2011 and early 2012, the University's SIGOps chapter managed development efforts focused on building the original compositing GUI. Since then, the project has mostly been a one-man effort with a handful of third party contributions.
+
+<h2>Kernel</h2>
+
+The Toaru kernel provides a basic Unix-like environment. The kernel uses a hybrid modular architecture, with loadable modules providing most device driver support. The core kernel includes support for Unix pipes and TTYs, a virtual file system, multitasking, ELF binary support, and various core platform features on x86 systems.
+Modules provide support for disk drives, ext2 filesystems, serial, keyboards and mice, a <mono>/proc</mono> filesystem similar to the one found in Linux, as well as an expanding collection of other device drivers.
+
+<h2>Userspace</h2>
+
+ToaruOS's userspace is focused on a rich graphical environment, backed by an in-house compositing window manager. ToaruOS's terminal emulator supports xterm-compatible 256-color modes, as well as Konsole 24-bit color modes and anti-aliased text with basic Unicode support. Program binaries are dynamically linked. Several graphical demos are provided, alongside a number of command-line applications. A port of SDL targetting the native graphical environment is also available.
+
+<h2>Third-Party Software</h2>
+
+The userspace depends on a number of third-party libraries which are outside of the development scope of the project. Additionally, several third-party applications and libraries have been integrated into ToaruOS's core userspace, or otherwise ported to ToaruOS.
+
+Please see the <link target="special:contents">Table of Contents</link> for a listing of licenses for included third-party software.
+
+<h2>Community</h2>
+
+You can join us through IRC in <mono>#toaruos</mono> on Freenode (<mono>irc.freenode.net</mono>).

+ 11 - 0
util/extra-help/calculator.trt

@@ -0,0 +1,11 @@
+
+<h1>Calculator</h1>
+
+<img src="/usr/share/icons/48/calculator.png"></img>
+A simple four-function calculator.
+
+<h2>Technical Details</h2>
+
+The calculator uses Python's integrated parsing and AST to format mathematical expressions. As such, some functions are different from a normal calculator. For example, you can use <mono>**</mono> as an exponent operator, parenthesis do not imply multiplication (<mono>2(4)</mono> is a syntax error; use <mono>2*(4)</mono> or similar instead), etc.
+
+

+ 5 - 0
util/extra-help/file_browser.trt

@@ -0,0 +1,5 @@
+
+<h1>File Browser</h1>
+
+<img src="/usr/share/icons/48/folder.png"></img>
+The <i>File Browser</i> allows visual navigation of the file system.

File diff suppressed because it is too large
+ 50 - 0
util/extra-help/help_browser.trt


+ 56 - 0
util/extra-help/licenses/0_toaruos.trt

@@ -0,0 +1,56 @@
+
+<h1>ToaruOS</h1>
+<mono>
+Copyright (c) 2011-2017 Kevin Lange.  All rights reserved.
+
+                          Dedicated to the memory of
+                               Dennis Ritchie
+                                  1941-2011
+
+Developed by: ToAruOS Kernel Development Team
+              http://toaruos.org
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal with the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+  1. Redistributions of source code must retain the above copyright notice,
+     this list of conditions and the following disclaimers.
+  2. Redistributions in binary form must reproduce the above copyright
+     notice, this list of conditions and the following disclaimers in the
+     documentation and/or other materials provided with the distribution.
+  3. Neither the names of the ToAruOS Kernel Development Team, Kevin Lange,
+     nor the names of its contributors may be used to endorse
+     or promote products derived from this Software without specific prior
+     written permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
+CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
+WITH THE SOFTWARE.
+</mono>
+<h2>Authors</h2>
+
+- Kevin Lange
+- Markus Schober
+- Tianyi Wang
+- Josh Kilmer
+- Patrick Lucas
+- Steve Jenson
+- Tyler Bindon
+- Mat "Lioncash" M.
+- Ivailo Monev
+- Dale Weiler
+- Mike Gerow
+- Matt White
+- Mike Gerow
+- Fabien Siron
+- Gil Mendes
+- Peter Harliman Liem
+- Shawn Anastasio
+

+ 39 - 0
util/extra-help/licenses/cairo.trt

@@ -0,0 +1,39 @@
+
+<h1>Cairo</h1>
+
+A copy of the LGPL v2.1 may be found <link target="licenses/lgpl-2.1.trt">here</link>.
+<mono>
+Cairo is free software.
+
+Every source file in the implementation[*] of cairo is available to be
+redistributed and/or modified under the terms of either the GNU Lesser
+General Public License (LGPL) version 2.1 or the Mozilla Public
+License (MPL) version 1.1.  Some files are available under more
+liberal terms, but we believe that in all cases, each file may be used
+under either the LGPL or the MPL.
+
+See the following files in this directory for the precise terms and
+conditions of either license:
+
+    COPYING-LGPL-2.1
+    COPYING-MPL-1.1
+
+Please see each file in the implementation for copyright and licensing
+information, (in the opening comment of each file).
+
+[*] The implementation of cairo is contained entirely within the "src"
+directory of the cairo source distribution. There are other components
+of the cairo source distribution (such as the "test", "util", and "perf")
+that are auxiliary to the library itself. None of the source code in these
+directories contributes to a build of the cairo library itself, (libcairo.so
+or cairo.dll or similar).
+
+These auxiliary components are also free software, but may be under
+different license terms than cairo itself. For example, most of the
+test cases in the perf and test directories are made available under
+an MIT license to simplify any use of this code for reference purposes
+in using cairo itself. Other files might be available under the GNU
+General Public License (GPL), for example. Again, please see the COPYING
+file under each directory and the opening comment of each file for copyright
+and licensing information.
+</mono>

+ 49 - 0
util/extra-help/licenses/font_dejavu.trt

@@ -0,0 +1,49 @@
+
+<h1>DejaVu / Bitstream Vera</h1>
+<mono>
+Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. Bitstream
+Vera is a trademark of Bitstream, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of the fonts accompanying this license ("Fonts") and associated
+documentation files (the "Font Software"), to reproduce and distribute
+the Font Software, including without limitation the rights to use,
+copy, merge, publish, distribute, and/or sell copies of the Font
+Software, and to permit persons to whom the Font Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright and trademark notices and this permission notice
+shall be included in all copies of one or more of the Font Software
+typefaces.
+
+The Font Software may be modified, altered, or added to, and in
+particular the designs of glyphs or characters in the Fonts may be
+modified and additional glyphs or characters may be added to the Fonts,
+only if the fonts are renamed to names not containing either the words
+"Bitstream" or the word "Vera".
+
+This License becomes null and void to the extent applicable to Fonts or
+Font Software that has been modified and is distributed under the
+"Bitstream Vera" names.
+
+The Font Software may be sold as part of a larger software package but
+no copy of one or more of the Font Software typefaces may be sold by
+itself.
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL
+BITSTREAM OR THE GNOME FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL,
+OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT
+SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.
+
+Except as contained in this notice, the names of Gnome, the Gnome
+Foundation, and Bitstream Inc., shall not be used in advertising or
+otherwise to promote the sale, use or other dealings in this Font
+Software without prior written authorization from the Gnome Foundation
+or Bitstream Inc., respectively. For further information, contact:
+fonts at gnome dot org.
+</mono>

+ 8 - 0
util/extra-help/licenses/font_symbola.trt

@@ -0,0 +1,8 @@
+
+<h1>Symbola</h1>
+<mono>
+In lieu of a license
+Fonts in this site are offered free for any use; they may be installed,
+embedded, opened, edited, modified, regenerated, posted,
+packaged and redistributed. - George Douros
+</mono>

+ 35 - 0
util/extra-help/licenses/font_vlgothic.trt

@@ -0,0 +1,35 @@
+
+<h1>VL Gothic</h1>
+<mono>
+Copyright (c) 1990-2003 Wada Laboratory, the University of Tokyo.
+Copyright (c) 2003-2004 Electronic Font Open Laboratory (/efont/).
+Copyright (C) 2002-2010 M+ FONTS PROJECT Copyright (C) 2006-2010
+Daisuke SUZUKI .  Copyright (C) 2006-2010 Project Vine .  All rights
+reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the Wada Laboratory, the University of Tokyo nor
+   the names of its contributors may be used to endorse or promote
+   products derived from this software without specific prior written
+   permission.
+
+THIS SOFTWARE IS PROVIDED BY WADA LABORATORY, THE UNIVERSITY OF TOKYO
+AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES,
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL THE LABORATORY OR CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+</mono>

+ 170 - 0
util/extra-help/licenses/freetype.trt

@@ -0,0 +1,170 @@
+
+<h1>Freetype</h1>
+<mono>
+                    The FreeType Project LICENSE
+                    ----------------------------
+
+                            2006-Jan-27
+
+                    Copyright 1996-2002, 2006 by
+          David Turner, Robert Wilhelm, and Werner Lemberg
+
+
+
+Introduction
+============
+
+  The FreeType  Project is distributed in  several archive packages;
+  some of them may contain, in addition to the FreeType font engine,
+  various tools and  contributions which rely on, or  relate to, the
+  FreeType Project.
+
+  This  license applies  to all  files found  in such  packages, and
+  which do not  fall under their own explicit  license.  The license
+  affects  thus  the  FreeType   font  engine,  the  test  programs,
+  documentation and makefiles, at the very least.
+
+  This  license   was  inspired  by  the  BSD,   Artistic,  and  IJG
+  (Independent JPEG  Group) licenses, which  all encourage inclusion
+  and  use of  free  software in  commercial  and freeware  products
+  alike.  As a consequence, its main points are that:
+
+    o We don't promise that this software works. However, we will be
+      interested in any kind of bug reports. (`as is' distribution)
+
+    o You can  use this software for whatever you  want, in parts or
+      full form, without having to pay us. (`royalty-free' usage)
+
+    o You may not pretend that  you wrote this software.  If you use
+      it, or  only parts of it,  in a program,  you must acknowledge
+      somewhere  in  your  documentation  that  you  have  used  the
+      FreeType code. (`credits')
+
+  We  specifically  permit  and  encourage  the  inclusion  of  this
+  software, with  or without modifications,  in commercial products.
+  We  disclaim  all warranties  covering  The  FreeType Project  and
+  assume no liability related to The FreeType Project.
+
+
+  Finally,  many  people  asked  us  for  a  preferred  form  for  a
+  credit/disclaimer to use in compliance with this license.  We thus
+  encourage you to use the following text:
+
+   """
+    Portions of this software are copyrigh © &lt;year&gt; The FreeType
+    Project (www.freetype.org).  All rights reserved.
+   """
+
+  Please replace &lt;year&gt; with the value from the FreeType version you
+  actually use.
+
+
+Legal Terms
+===========
+
+0. Definitions
+--------------
+
+  Throughout this license,  the terms `package', `FreeType Project',
+  and  `FreeType  archive' refer  to  the  set  of files  originally
+  distributed  by the  authors  (David Turner,  Robert Wilhelm,  and
+  Werner Lemberg) as the `FreeType Project', be they named as alpha,
+  beta or final release.
+
+  `You' refers to  the licensee, or person using  the project, where
+  `using' is a generic term including compiling the project's source
+  code as  well as linking it  to form a  `program' or `executable'.
+  This  program is  referred to  as  `a program  using the  FreeType
+  engine'.
+
+  This  license applies  to all  files distributed  in  the original
+  FreeType  Project,   including  all  source   code,  binaries  and
+  documentation,  unless  otherwise  stated   in  the  file  in  its
+  original, unmodified form as  distributed in the original archive.
+  If you are  unsure whether or not a particular  file is covered by
+  this license, you must contact us to verify this.
+
+  The FreeType  Project is copyright (C) 1996-2000  by David Turner,
+  Robert Wilhelm, and Werner Lemberg.  All rights reserved except as
+  specified below.
+
+1. No Warranty
+--------------
+
+  THE FREETYPE PROJECT  IS PROVIDED `AS IS' WITHOUT  WARRANTY OF ANY
+  KIND, EITHER  EXPRESS OR IMPLIED,  INCLUDING, BUT NOT  LIMITED TO,
+  WARRANTIES  OF  MERCHANTABILITY   AND  FITNESS  FOR  A  PARTICULAR
+  PURPOSE.  IN NO EVENT WILL ANY OF THE AUTHORS OR COPYRIGHT HOLDERS
+  BE LIABLE  FOR ANY DAMAGES CAUSED  BY THE USE OR  THE INABILITY TO
+  USE, OF THE FREETYPE PROJECT.
+
+2. Redistribution
+-----------------
+
+  This  license  grants  a  worldwide, royalty-free,  perpetual  and
+  irrevocable right  and license to use,  execute, perform, compile,
+  display,  copy,   create  derivative  works   of,  distribute  and
+  sublicense the  FreeType Project (in  both source and  object code
+  forms)  and  derivative works  thereof  for  any  purpose; and  to
+  authorize others  to exercise  some or all  of the  rights granted
+  herein, subject to the following conditions:
+
+    o Redistribution of  source code  must retain this  license file
+      (`FTL.TXT') unaltered; any  additions, deletions or changes to
+      the original  files must be clearly  indicated in accompanying
+      documentation.   The  copyright   notices  of  the  unaltered,
+      original  files must  be  preserved in  all  copies of  source
+      files.
+
+    o Redistribution in binary form must provide a  disclaimer  that
+      states  that  the software is based in part of the work of the
+      FreeType Team,  in  the  distribution  documentation.  We also
+      encourage you to put an URL to the FreeType web page  in  your
+      documentation, though this isn't mandatory.
+
+  These conditions  apply to any  software derived from or  based on
+  the FreeType Project,  not just the unmodified files.   If you use
+  our work, you  must acknowledge us.  However, no  fee need be paid
+  to us.
+
+3. Advertising
+--------------
+
+  Neither the  FreeType authors and  contributors nor you  shall use
+  the name of the  other for commercial, advertising, or promotional
+  purposes without specific prior written permission.
+
+  We suggest,  but do not require, that  you use one or  more of the
+  following phrases to refer  to this software in your documentation
+  or advertising  materials: `FreeType Project',  `FreeType Engine',
+  `FreeType library', or `FreeType Distribution'.
+
+  As  you have  not signed  this license,  you are  not  required to
+  accept  it.   However,  as  the FreeType  Project  is  copyrighted
+  material, only  this license, or  another one contracted  with the
+  authors, grants you  the right to use, distribute,  and modify it.
+  Therefore,  by  using,  distributing,  or modifying  the  FreeType
+  Project, you indicate that you understand and accept all the terms
+  of this license.
+
+4. Contacts
+-----------
+
+  There are two mailing lists related to FreeType:
+
+    o freetype@nongnu.org
+
+      Discusses general use and applications of FreeType, as well as
+      future and  wanted additions to the  library and distribution.
+      If  you are looking  for support,  start in  this list  if you
+      haven't found anything to help you in the documentation.
+
+    o freetype-devel@nongnu.org
+
+      Discusses bugs,  as well  as engine internals,  design issues,
+      specific licenses, porting, etc.
+
+  Our home page can be found at
+
+      http://www.freetype.org
+</mono>

+ 23 - 0
util/extra-help/licenses/gears.trt

@@ -0,0 +1,23 @@
+
+<h1>GL Gears</h1>
+<mono>
+Copyright (C) 1999-2001 Brian Paul All Rights Reserved.
+              2013 Kevin Lange <klange@dakko.us>
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+</mono>

+ 506 - 0
util/extra-help/licenses/lgpl-2.1.trt

@@ -0,0 +1,506 @@
+
+<h1>GNU Lesser General Public License (LGPL) 2.1</h1>
+<mono>
+                  GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 2.1, February 1999
+
+ Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+ 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+  When we speak of free software, we are referring to freedom of use,
+not price.  Our General Public Licenses are designed to make sure that
+you have the freedom to distribute copies of free software (and charge
+for this service if you wish); that you receive source code or can get
+it if you want it; that you can change the software and use pieces of
+it in new free programs; and that you are informed that you can do
+these things.
+
+  To protect your rights, we need to make restrictions that forbid
+distributors to deny you these rights or to ask you to surrender these
+rights.  These restrictions translate to certain responsibilities for
+you if you distribute copies of the library or if you modify it.
+
+  For example, if you distribute copies of the library, whether gratis
+or for a fee, you must give the recipients all the rights that we gave
+you.  You must make sure that they, too, receive or can get the source
+code.  If you link other code with the library, you must provide
+complete object files to the recipients, so that they can relink them
+with the library after making changes to the library and recompiling
+it.  And you must show them these terms so they know their rights.
+
+  We protect your rights with a two-step method: (1) we copyright the
+library, and (2) we offer you this license, which gives you legal
+permission to copy, distribute and/or modify the library.
+
+  To protect each distributor, we want to make it very clear that
+there is no warranty for the free library.  Also, if the library is
+modified by someone else and passed on, the recipients should know
+that what they have is not the original version, so that the original
+author's reputation will not be affected by problems that might be
+introduced by others.
+
+  Finally, software patents pose a constant threat to the existence of
+any free program.  We wish to make sure that a company cannot
+effectively restrict the users of a free program by obtaining a
+restrictive license from a patent holder.  Therefore, we insist that
+any patent license obtained for a version of the library must be
+consistent with the full freedom of use specified in this license.
+
+  Most GNU software, including some libraries, is covered by the
+ordinary GNU General Public License.  This license, the GNU Lesser
+General Public License, applies to certain designated libraries, and
+is quite different from the ordinary General Public License.  We use
+this license for certain libraries in order to permit linking those
+libraries into non-free programs.
+
+  When a program is linked with a library, whether statically or using
+a shared library, the combination of the two is legally speaking a
+combined work, a derivative of the original library.  The ordinary
+General Public License therefore permits such linking only if the
+entire combination fits its criteria of freedom.  The Lesser General
+Public License permits more lax criteria for linking other code with
+the library.
+
+  We call this license the "Lesser" General Public License because it
+does Less to protect the user's freedom than the ordinary General
+Public License.  It also provides other free software developers Less
+of an advantage over competing non-free programs.  These disadvantages
+are the reason we use the ordinary General Public License for many
+libraries.  However, the Lesser license provides advantages in certain
+special circumstances.
+
+  For example, on rare occasions, there may be a special need to
+encourage the widest possible use of a certain library, so that it becomes
+a de-facto standard.  To achieve this, non-free programs must be
+allowed to use the library.  A more frequent case is that a free
+library does the same job as widely used non-free libraries.  In this
+case, there is little to gain by limiting the free library to free
+software only, so we use the Lesser General Public License.
+
+  In other cases, permission to use a particular library in non-free
+programs enables a greater number of people to use a large body of
+free software.  For example, permission to use the GNU C Library in
+non-free programs enables many more people to use the whole GNU
+operating system, as well as its variant, the GNU/Linux operating
+system.
+
+  Although the Lesser General Public License is Less protective of the
+users' freedom, it does ensure that the user of a program that is
+linked with the Library has the freedom and the wherewithal to run
+that program using a modified version of the Library.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.  Pay close attention to the difference between a
+"work based on the library" and a "work that uses the library".  The
+former contains code derived from the library, whereas the latter must
+be combined with the library in order to run.
+
+                  GNU LESSER GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any software library or other
+program which contains a notice placed by the copyright holder or
+other authorized party saying it may be distributed under the terms of
+this Lesser General Public License (also called "this License").
+Each licensee is addressed as "you".
+
+  A "library" means a collection of software functions and/or data
+prepared so as to be conveniently linked with application programs
+(which use some of those functions and data) to form executables.
+
+  The "Library", below, refers to any such software library or work
+which has been distributed under these terms.  A "work based on the
+Library" means either the Library or any derivative work under
+copyright law: that is to say, a work containing the Library or a
+portion of it, either verbatim or with modifications and/or translated
+straightforwardly into another language.  (Hereinafter, translation is
+included without limitation in the term "modification".)
+
+  "Source code" for a work means the preferred form of the work for
+making modifications to it.  For a library, complete source code means
+all the source code for all modules it contains, plus any associated
+interface definition files, plus the scripts used to control compilation
+and installation of the library.
+
+  Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running a program using the Library is not restricted, and output from
+such a program is covered only if its contents constitute a work based
+on the Library (independent of the use of the Library in a tool for
+writing it).  Whether that is true depends on what the Library does
+and what the program that uses the Library does.
+
+  1. You may copy and distribute verbatim copies of the Library's
+complete source code as you receive it, in any medium, provided that
+you conspicuously and appropriately publish on each copy an
+appropriate copyright notice and disclaimer of warranty; keep intact
+all the notices that refer to this License and to the absence of any
+warranty; and distribute a copy of this License along with the
+Library.
+
+  You may charge a fee for the physical act of transferring a copy,
+and you may at your option offer warranty protection in exchange for a
+fee.
+
+  2. You may modify your copy or copies of the Library or any portion
+of it, thus forming a work based on the Library, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) The modified work must itself be a software library.
+
+    b) You must cause the files modified to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    c) You must cause the whole of the work to be licensed at no
+    charge to all third parties under the terms of this License.
+
+    d) If a facility in the modified Library refers to a function or a
+    table of data to be supplied by an application program that uses
+    the facility, other than as an argument passed when the facility
+    is invoked, then you must make a good faith effort to ensure that,
+    in the event an application does not supply such function or
+    table, the facility still operates, and performs whatever part of
+    its purpose remains meaningful.
+
+    (For example, a function in a library to compute square roots has
+    a purpose that is entirely well-defined independent of the
+    application.  Therefore, Subsection 2d requires that any
+    application-supplied function or table used by this function must
+    be optional: if the application does not supply it, the square
+    root function must still compute square roots.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Library,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Library, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote
+it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Library.
+
+In addition, mere aggregation of another work not based on the Library
+with the Library (or with a work based on the Library) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may opt to apply the terms of the ordinary GNU General Public
+License instead of this License to a given copy of the Library.  To do
+this, you must alter all the notices that refer to this License, so
+that they refer to the ordinary GNU General Public License, version 2,
+instead of to this License.  (If a newer version than version 2 of the
+ordinary GNU General Public License has appeared, then you can specify
+that version instead if you wish.)  Do not make any other change in
+these notices.
+
+  Once this change is made in a given copy, it is irreversible for
+that copy, so the ordinary GNU General Public License applies to all
+subsequent copies and derivative works made from that copy.
+
+  This option is useful when you wish to copy part of the code of
+the Library into a program that is not a library.
+
+  4. You may copy and distribute the Library (or a portion or
+derivative of it, under Section 2) in object code or executable form
+under the terms of Sections 1 and 2 above provided that you accompany
+it with the complete corresponding machine-readable source code, which
+must be distributed under the terms of Sections 1 and 2 above on a
+medium customarily used for software interchange.
+
+  If distribution of object code is made by offering access to copy
+from a designated place, then offering equivalent access to copy the
+source code from the same place satisfies the requirement to
+distribute the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  5. A program that contains no derivative of any portion of the
+Library, but is designed to work with the Library by being compiled or
+linked with it, is called a "work that uses the Library".  Such a
+work, in isolation, is not a derivative work of the Library, and
+therefore falls outside the scope of this License.
+
+  However, linking a "work that uses the Library" with the Library
+creates an executable that is a derivative of the Library (because it
+contains portions of the Library), rather than a "work that uses the
+library".  The executable is therefore covered by this License.
+Section 6 states terms for distribution of such executables.
+
+  When a "work that uses the Library" uses material from a header file
+that is part of the Library, the object code for the work may be a
+derivative work of the Library even though the source code is not.
+Whether this is true is especially significant if the work can be
+linked without the Library, or if the work is itself a library.  The
+threshold for this to be true is not precisely defined by law.
+
+  If such an object file uses only numerical parameters, data
+structure layouts and accessors, and small macros and small inline
+functions (ten lines or less in length), then the use of the object
+file is unrestricted, regardless of whether it is legally a derivative
+work.  (Executables containing this object code plus portions of the
+Library will still fall under Section 6.)
+
+  Otherwise, if the work is a derivative of the Library, you may
+distribute the object code for the work under the terms of Section 6.
+Any executables containing that work also fall under Section 6,
+whether or not they are linked directly with the Library itself.
+
+  6. As an exception to the Sections above, you may also combine or
+link a "work that uses the Library" with the Library to produce a
+work containing portions of the Library, and distribute that work
+under terms of your choice, provided that the terms permit
+modification of the work for the customer's own use and reverse
+engineering for debugging such modifications.
+
+  You must give prominent notice with each copy of the work that the
+Library is used in it and that the Library and its use are covered by
+this License.  You must supply a copy of this License.  If the work
+during execution displays copyright notices, you must include the
+copyright notice for the Library among them, as well as a reference
+directing the user to the copy of this License.  Also, you must do one
+of these things:
+
+    a) Accompany the work with the complete corresponding
+    machine-readable source code for the Library including whatever
+    changes were used in the work (which must be distributed under
+    Sections 1 and 2 above); and, if the work is an executable linked
+    with the Library, with the complete machine-readable "work that
+    uses the Library", as object code and/or source code, so that the
+    user can modify the Library and then relink to produce a modified
+    executable containing the modified Library.  (It is understood
+    that the user who changes the contents of definitions files in the
+    Library will not necessarily be able to recompile the application
+    to use the modified definitions.)
+
+    b) Use a suitable shared library mechanism for linking with the
+    Library.  A suitable mechanism is one that (1) uses at run time a
+    copy of the library already present on the user's computer system,
+    rather than copying library functions into the executable, and (2)
+    will operate properly with a modified version of the library, if
+    the user installs one, as long as the modified version is
+    interface-compatible with the version that the work was made with.
+
+    c) Accompany the work with a written offer, valid for at
+    least three years, to give the same user the materials
+    specified in Subsection 6a, above, for a charge no more
+    than the cost of performing this distribution.
+
+    d) If distribution of the work is made by offering access to copy
+    from a designated place, offer equivalent access to copy the above
+    specified materials from the same place.
+
+    e) Verify that the user has already received a copy of these
+    materials or that you have already sent this user a copy.
+
+  For an executable, the required form of the "work that uses the
+Library" must include any data and utility programs needed for
+reproducing the executable from it.  However, as a special exception,
+the materials to be distributed need not include anything that is
+normally distributed (in either source or binary form) with the major
+components (compiler, kernel, and so on) of the operating system on
+which the executable runs, unless that component itself accompanies
+the executable.
+
+  It may happen that this requirement contradicts the license
+restrictions of other proprietary libraries that do not normally
+accompany the operating system.  Such a contradiction means you cannot
+use both them and the Library together in an executable that you
+distribute.
+
+  7. You may place library facilities that are a work based on the
+Library side-by-side in a single library together with other library
+facilities not covered by this License, and distribute such a combined
+library, provided that the separate distribution of the work based on
+the Library and of the other library facilities is otherwise
+permitted, and provided that you do these two things:
+
+    a) Accompany the combined library with a copy of the same work
+    based on the Library, uncombined with any other library
+    facilities.  This must be distributed under the terms of the
+    Sections above.
+
+    b) Give prominent notice with the combined library of the fact
+    that part of it is a work based on the Library, and explaining
+    where to find the accompanying uncombined form of the same work.
+
+  8. You may not copy, modify, sublicense, link with, or distribute
+the Library except as expressly provided under this License.  Any
+attempt otherwise to copy, modify, sublicense, link with, or
+distribute the Library is void, and will automatically terminate your
+rights under this License.  However, parties who have received copies,
+or rights, from you under this License will not have their licenses
+terminated so long as such parties remain in full compliance.
+
+  9. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Library or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Library (or any work based on the
+Library), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Library or works based on it.
+
+  10. Each time you redistribute the Library (or any work based on the
+Library), the recipient automatically receives a license from the
+original licensor to copy, distribute, link with or modify the Library
+subject to these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties with
+this License.
+
+  11. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Library at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Library by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Library.
+
+If any portion of this section is held invalid or unenforceable under any
+particular circumstance, the balance of the section is intended to apply,
+and the section as a whole is intended to apply in other circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  12. If the distribution and/or use of the Library is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Library under this License may add
+an explicit geographical distribution limitation excluding those countries,
+so that distribution is permitted only in or among countries not thus
+excluded.  In such case, this License incorporates the limitation as if
+written in the body of this License.
+
+  13. The Free Software Foundation may publish revised and/or new
+versions of the Lesser General Public License from time to time.
+Such new versions will be similar in spirit to the present version,
+but may differ in detail to address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Library
+specifies a version number of this License which applies to it and
+"any later version", you have the option of following the terms and
+conditions either of that version or of any later version published by
+the Free Software Foundation.  If the Library does not specify a
+license version number, you may choose any version ever published by
+the Free Software Foundation.
+
+  14. If you wish to incorporate parts of the Library into other free
+programs whose distribution conditions are incompatible with these,
+write to the author to ask for permission.  For software which is
+copyrighted by the Free Software Foundation, write to the Free
+Software Foundation; we sometimes make exceptions for this.  Our
+decision will be guided by the two goals of preserving the free status
+of all derivatives of our free software and of promoting the sharing
+and reuse of software generally.
+
+                            NO WARRANTY
+
+  15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
+WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
+EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
+OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
+KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
+LIBRARY IS WITH YOU.  SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
+THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
+WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
+AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
+FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
+CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
+LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
+RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
+FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
+SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
+DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+           How to Apply These Terms to Your New Libraries
+
+  If you develop a new library, and you want it to be of the greatest
+possible use to the public, we recommend making it free software that
+everyone can redistribute and change.  You can do so by permitting
+redistribution under these terms (or, alternatively, under the terms of the
+ordinary General Public License).
+
+  To apply these terms, attach the following notices to the library.  It is
+safest to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least the
+"copyright" line and a pointer to where the full notice is found.
+
+    &lt;one line to give the library's name and a brief idea of what it does.&gt;
+    Copyright (C) &lt;year&gt;  &lt;name of author&gt;
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the library, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  library `Frob' (a library for tweaking knobs) written by James Random Hacker.
+
+  &lt;signature of Ty Coon&gt;, 1 April 1990
+  Ty Coon, President of Vice
+
+That's all there is to it!
+</mono>

+ 169 - 0
util/extra-help/licenses/lgpl-3.0.trt

@@ -0,0 +1,169 @@
+
+<h1>GNU Lesser General Public License (LGPL) 3.0</h1>
+<mono>
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+</mono>

+ 135 - 0
util/extra-help/licenses/png.trt

@@ -0,0 +1,135 @@
+
+<h1>libpng</h1>
+<mono>
+
+This copy of the libpng notices is provided for your convenience.  In case of
+any discrepancy between this copy and the notices in the file png.h that is
+included in the libpng distribution, the latter shall prevail.
+
+COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
+
+If you modify libpng you may insert additional notices immediately following
+this sentence.
+
+This code is released under the libpng license.
+
+libpng versions 1.0.7, July 1, 2000 through 1.6.28, January 5, 2017 are
+Copyright (c) 2000-2002, 2004, 2006-2017 Glenn Randers-Pehrson, are
+derived from libpng-1.0.6, and are distributed according to the same
+disclaimer and license as libpng-1.0.6 with the following individuals
+added to the list of Contributing Authors:
+
+   Simon-Pierre Cadieux
+   Eric S. Raymond
+   Mans Rullgard
+   Cosmin Truta
+   Gilles Vollant
+   James Yu
+   Mandar Sahastrabuddhe
+
+and with the following additions to the disclaimer:
+
+   There is no warranty against interference with your enjoyment of the
+   library or against infringement.  There is no warranty that our
+   efforts or the library will fulfill any of your particular purposes
+   or needs.  This library is provided with all faults, and the entire
+   risk of satisfactory quality, performance, accuracy, and effort is with
+   the user.
+
+Some files in the "contrib" directory and some configure-generated
+files that are distributed with libpng have other copyright owners and
+are released under other open source licenses.
+
+libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
+Copyright (c) 1998-2000 Glenn Randers-Pehrson, are derived from
+libpng-0.96, and are distributed according to the same disclaimer and
+license as libpng-0.96, with the following individuals added to the list
+of Contributing Authors:
+
+   Tom Lane
+   Glenn Randers-Pehrson
+   Willem van Schaik
+
+libpng versions 0.89, June 1996, through 0.96, May 1997, are
+Copyright (c) 1996-1997 Andreas Dilger, are derived from libpng-0.88,
+and are distributed according to the same disclaimer and license as
+libpng-0.88, with the following individuals added to the list of
+Contributing Authors:
+
+   John Bowler
+   Kevin Bracey
+   Sam Bushell
+   Magnus Holmgren
+   Greg Roelofs
+   Tom Tanner
+
+Some files in the "scripts" directory have other copyright owners
+but are released under this license.
+
+libpng versions 0.5, May 1995, through 0.88, January 1996, are
+Copyright (c) 1995-1996 Guy Eric Schalnat, Group 42, Inc.
+
+For the purposes of this copyright and license, "Contributing Authors"
+is defined as the following set of individuals:
+
+   Andreas Dilger
+   Dave Martindale
+   Guy Eric Schalnat
+   Paul Schmidt
+   Tim Wegner
+
+The PNG Reference Library is supplied "AS IS".  The Contributing Authors
+and Group 42, Inc. disclaim all warranties, expressed or implied,
+including, without limitation, the warranties of merchantability and of
+fitness for any purpose.  The Contributing Authors and Group 42, Inc.
+assume no liability for direct, indirect, incidental, special, exemplary,
+or consequential damages, which may result from the use of the PNG
+Reference Library, even if advised of the possibility of such damage.
+
+Permission is hereby granted to use, copy, modify, and distribute this
+source code, or portions hereof, for any purpose, without fee, subject
+to the following restrictions:
+
+  1. The origin of this source code must not be misrepresented.
+
+  2. Altered versions must be plainly marked as such and must not
+     be misrepresented as being the original source.
+
+  3. This Copyright notice may not be removed or altered from any
+     source or altered source distribution.
+
+The Contributing Authors and Group 42, Inc. specifically permit, without
+fee, and encourage the use of this source code as a component to
+supporting the PNG file format in commercial products.  If you use this
+source code in a product, acknowledgment is not required but would be
+appreciated.
+
+END OF COPYRIGHT NOTICE, DISCLAIMER, and LICENSE.
+
+TRADEMARK:
+
+The name "libpng" has not been registered by the Copyright owner
+as a trademark in any jurisdiction.  However, because libpng has
+been distributed and maintained world-wide, continually since 1995,
+the Copyright owner claims "common-law trademark protection" in any
+jurisdiction where common-law trademark is recognized.
+
+OSI CERTIFICATION:
+
+Libpng is OSI Certified Open Source Software.  OSI Certified Open Source is
+a certification mark of the Open Source Initiative. OSI has not addressed
+the additional disclaimers inserted at version 1.0.7.
+
+EXPORT CONTROL:
+
+The Copyright owner believes that the Export Control Classification
+Number (ECCN) for libpng is EAR99, which means not subject to export
+controls or International Traffic in Arms Regulations (ITAR) because
+it is open source, publicly available software, that does not contain
+any encryption software.  See the EAR, paragraphs 734.3(b)(3) and
+734.7(b).
+
+Glenn Randers-Pehrson
+glennrp at users.sourceforge.net
+January 5, 2017
+</mono>

+ 7 - 0
util/extra-help/licenses/pycairo.trt

@@ -0,0 +1,7 @@
+
+
+<h1>PyCairo</h1>
+
+<mono>pycairo</mono> is licensed under the GNU Lesser General Public License (LGPL) version 3.
+
+A copy of the LGPL v3 may be found <link target="licenses/lgpl-3.0.trt">here</link>.

+ 8 - 0
util/extra-help/licenses/python.trt

@@ -0,0 +1,8 @@
+
+<h1>Python</h1>
+
+The license for Python may be viewed by running the following command:
+<mono>
+    python -c "license()"
+</mono>
+

+ 8 - 0
util/extra-help/mines.trt

@@ -0,0 +1,8 @@
+
+<h1>Mines</h1>
+
+<img src="/usr/share/icons/48/mines.png"></img>
+Implementation of the classic logic game.
+
+Click to reveal, ctrl+click to flag / unflag.
+

+ 5 - 0
util/extra-help/packages.trt

@@ -0,0 +1,5 @@
+
+<h1>Package Manager</h1>
+
+<img src="/usr/share/icons/48/package.png"></img>
+The <i>Package Manager</i> can be used to browse and install available packages.

+ 14 - 0
util/extra-help/painting.trt

@@ -0,0 +1,14 @@
+
+<h1>ToaruPaint</h1>
+
+<img src="/usr/share/icons/48/applications-painting.png"></img>
+Draw things with this simple painting tool.
+
+<h2>Controls</h2>
+
+Select colors using the color picker (Tools > Color).
+
+Change the brush size by scrolling the mouse wheel up and down.
+
+Drag the viewport with the middle mouse button.
+

+ 6 - 0
util/fix-python.sh

@@ -51,3 +51,9 @@ cp util/readline._py $HDD_PATH/usr/python/lib/python3.6/
 echo "Installing demos..."
 mkdir -p base/usr/share/python-demos
 cp util/python-demos/*.py base/usr/share/python-demos/
+
+echo "Installing Help Browser files..."
+mkdir -p base/usr/share/help
+mkdir -p base/usr/share/help/licenses
+cp util/extra-help/*.trt base/usr/share/help/
+cp util/extra-help/licenses/*.trt base/usr/share/help/licenses/

+ 508 - 0
util/python-demos/help-browser.py

@@ -0,0 +1,508 @@
+#!/usr/bin/python3
+"""
+Help Documentation Browser
+"""
+import os
+import sys
+import subprocess
+
+import cairo
+
+import yutani
+import toaru_fonts
+import text_region
+
+from menu_bar import MenuBarWidget, MenuEntryAction, MenuEntrySubmenu, MenuEntryDivider, MenuWindow
+from about_applet import AboutAppletWindow
+from dialog import DialogWindow
+
+import yutani_mainloop
+
+app_name = "Help Browser"
+version = "1.0.0"
+_description = f"<b>{app_name} {version}</b>\n© 2017 Kevin Lange\n\nRich text help document viewer.\n\n<color 0x0000FF>http://github.com/klange/toaruos</color>"
+
+class ScrollableText(object):
+
+    def __init__(self):
+        self.tr = None
+        self.width = 0
+        self.height_ext = 0
+        self.height_int = 0
+        self.text_buffer = None
+        self.background = (1,1,1)
+        self.pad = 10
+
+    def destroy(self):
+        if self.text_buffer:
+            self.text_buffer.destroy()
+
+    def update(self, width):
+
+        needs_resize = False
+
+        if width != self.width:
+            needs_resize = True
+            self.width = width
+
+        self.tr.resize(self.width-self.pad*2, self.tr.line_height)
+        h = self.tr.line_height * len(self.tr.lines) + self.pad*2
+        if h != self.height_int:
+            needs_resize = True
+            self.height_int = h
+
+        if self.height_int - self.pad * 2 > 30000:
+            # Shit...
+            self.height_int = 30000 - self.pad * 2
+
+        self.tr.resize(self.width-self.pad*2, self.height_int-self.pad*2)
+        self.tr.move(self.pad,self.pad)
+
+        if needs_resize or not self.text_buffer:
+            if self.text_buffer:
+                self.text_buffer.destroy()
+            self.text_buffer = yutani.GraphicsBuffer(self.width,self.height_int)
+
+        surface = self.text_buffer.get_cairo_surface()
+        ctx = cairo.Context(surface)
+        ctx.rectangle(0,0,surface.get_width(),surface.get_height())
+        ctx.set_source_rgb(*self.background)
+        ctx.fill()
+
+        self.tr.draw(self.text_buffer)
+
+    def scroll_max(self):
+        if self.height_ext > self.height_int:
+            return 0
+
+        return self.height_int - self.height_ext
+
+
+    def draw(self,ctx,x,y,height,scroll):
+        self.height_ext = height
+        surface = self.text_buffer.get_cairo_surface()
+        ctx.rectangle(x,y,self.width,height)
+        ctx.set_source_surface(surface,x,y-scroll)
+        ctx.fill()
+
+class HelpBrowserWindow(yutani.Window):
+
+    base_width = 800
+    base_height = 600
+
+    def __init__(self, decorator):
+        super(HelpBrowserWindow, self).__init__(self.base_width + decorator.width(), self.base_height + decorator.height(), title=app_name, icon="help", doublebuffer=True)
+        self.move(100,100)
+        self.decorator = decorator
+        self.current_topic = "0_index.trt"
+        self.text_buffer = None
+        self.text_offset = 0
+        self.tr = None
+        self.size_changed = True
+        self.text_scroller = ScrollableText()
+
+        self.special = {}
+        self.special['contents'] = self.special_contents
+        self.special['demo'] = self.special_demo
+        self.down_text = None
+        self.cache = {}
+        self.history = []
+        self.history_index = 0
+        self.title_cache = {}
+
+        def herp(action):
+            print(action)
+
+        self.history_menu = MenuEntrySubmenu('History...',[MenuEntryDivider()])
+
+        def exit_app(action):
+            menus = [x for x in self.menus.values()]
+            for x in menus:
+                x.definitely_close()
+            self.close()
+            sys.exit(0)
+
+        def about_window(action):
+            AboutAppletWindow(self.decorator,f"About {app_name}","/usr/share/icons/48/help.png",_description,"help")
+
+        menus = [
+            ("File", [
+                #MenuEntryAction("Open...",None,print_derp,None),
+                #MenuEntryDivider(),
+                MenuEntryAction("Exit","exit",exit_app,None),
+            ]),
+            ("Go", [
+                MenuEntryAction("Home","home",self.go_page,"0_index.trt"),
+                MenuEntryAction("Topics","bookmark",self.go_page,"special:contents"),
+                MenuEntryDivider(),
+                self.history_menu,
+                MenuEntryAction("Back","back",self.go_back,None),
+                MenuEntryAction("Forward","forward",self.go_forward,None),
+            ]),
+            ("Help", [
+                MenuEntryAction("Contents","help",self.go_page,"help_browser.trt"),
+                MenuEntryDivider(),
+                MenuEntryAction(f"About {app_name}","star",about_window,None),
+            ]),
+        ]
+
+        self.menubar = MenuBarWidget(self,menus)
+
+        self.menus = {}
+        self.hovered_menu = None
+
+        self.update_text_buffer()
+        self.navigate("0_index.trt")
+
+
+    def get_title(self, document):
+        if document.startswith("special:"):
+            if document[8:] in self.special:
+                return self.special[document[8:]].__doc__
+            return "???"
+        elif document.startswith("http:") or document.startswith('https:'):
+            if document in self.title_cache:
+                return self.title_cache[document]
+            if document in self.cache:
+                lines = self.cache[document].split('\n')
+                for x in lines:
+                    x = x.strip()
+                    if x.startswith('<h1>') and x.endswith('</h1>'):
+                        return x[4:-5]
+                return document.split('/')[-1].replace('.trt','').title()
+            else:
+                return document
+        elif document.startswith("file:"):
+            path = document.replace("file:","")
+        else:
+            path = f'/usr/share/help/{document}'
+        if not os.path.exists(path):
+            return "(file not found)"
+        with open(path,'r') as f:
+            lines = f.readlines()
+            for x in lines:
+                x = x.strip()
+                if x.startswith('<h1>') and x.endswith('</h1>'):
+                    return x[4:-5]
+            return document.replace('.trt','').title()
+
+    def special_contents(self):
+        """Table of Contents"""
+        # List all things.
+        output = "\n<h1>Table of Contents</h1>\n\nThis table of contents is automatically generated.\n\n"
+        output += "<h2>Special Pages</h2>\n\n"
+        for k in self.special:
+            output += f"➤ <link target=\"special:{k}\">{self.special[k].__doc__}</link>\n"
+        output += "\n<h2>Documentation</h2>\n\n"
+        for k in sorted(os.listdir('/usr/share/help')):
+            if k.endswith('.trt'):
+                output += f"➤ <link target=\"{k}\">{self.get_title(k)}</link>\n"
+        for directory,_,files in os.walk('/usr/share/help'):
+            if directory == '/usr/share/help':
+                continue
+            files = sorted([x for x in files if not x.startswith('.')])
+            if files:
+                d = directory.replace('/usr/share/help/','')
+                output += "\n<h3>" + d.title() + "</h3>\n\n"
+                for k in files:
+                    if k.endswith('.trt'):
+                        k = d + '/' + k
+                        output += f"➤ <link target=\"{k}\">{self.get_title(k)}</link>\n"
+        return output
+
+    def special_demo(self):
+        """Formatting demo"""
+        return f"""
+
+<h1>This is a big header</h1>
+This is text below that.
+<h2>This is a medium header</h2>
+
+<h3>This is a small header</h3>
+
+This is normal text. <b>This is bold text.</b> <i>This is italic text.</i> <b><i>This is both.</i></b>
+<link target=\"0_index.trt\">go home</link>"""
+
+    def get_cache(self, url):
+        if url in self.cache:
+            return self.cache[url]
+        else:
+            try:
+                text = subprocess.check_output(['fetch',url])
+                if text.startswith(b'\x89PNG'):
+                    text = f"<html><body><img src=\"{url}\"></body></html>"
+                else:
+                    text = text.decode('utf-8')
+            except:
+                text = '\n<h1>Error</h1>\n\nThere was an error obtaining this file.'
+            self.cache[url] = text
+            return text
+
+    def get_document_text(self):
+        if self.current_topic.startswith("special:"):
+            if self.current_topic[8:] in self.special:
+                return self.special[self.current_topic[8:]]()
+        elif self.current_topic.startswith("http:") or self.current_topic.startswith('https:'):
+            # Good luck
+            return self.get_cache(self.current_topic)
+        elif self.current_topic.startswith("file:"):
+            path = self.current_topic.replace("file:","")
+        else:
+            path = f'/usr/share/help/{self.current_topic}'
+        if os.path.exists(path):
+            with open(path,'r') as f:
+                return f.read()
+        return f"""
+<h1>Document Not Found</h1>
+
+Uh oh, looks like the help document you tried to open ({self.current_topic}) wasn't available. Do you want to <link target=\"0_index.trt\">return to the index</link>?
+
+You can also <link target=\"special:contents\">check the Table of Contents</link>.
+
+"""
+
+    def is_html(self):
+        if self.current_topic.endswith('.html') or self.current_topic.endswith('.htm'): return True
+        if self.current_topic.startswith('http') and not self.current_topic.endswith('.trt'): return True
+        if '<html' in self.get_document_text(): return True
+        return False
+
+    def update_history(self):
+        def go_history(action):
+            self.navigate(self.history[action],touch_history=False)
+            self.history_index = action
+            self.update_history()
+        entries = []
+        for x in range(len(self.history)):
+            t = self.get_title(self.history[x])
+            e = MenuEntryAction(t,None,go_history,x)
+            if x == self.history_index:
+                e.title = f'<b>{t}</b>'
+                e.rich = True
+                e.update_text()
+            entries.append(e)
+        entries.reverse()
+        self.history_menu.entries = entries
+
+    def navigate(self, target, touch_history=True):
+        #if target.startswith('https:'):
+        #    DialogWindow(self.decorator,app_name,f"<mono>https</mono> is not supported. Could not load the URL <mono>{target}</mono>",callback=lambda: None,window=self,cancel_label=False)
+        #    return
+        if touch_history:
+            del self.history[self.history_index+1:]
+            self.history.append(target)
+            self.history_index = len(self.history)-1
+        self.current_topic = target
+        self.text_offset = 0
+        if self.is_html():
+            self.tr.base_dir = os.path.dirname(target) + '/'
+        else:
+            self.tr.base_dir = '/usr/share/help/'
+        self.tr.set_richtext(self.get_document_text(),html=self.is_html())
+        self.update_text_buffer()
+        if self.tr.title:
+            self.set_title(f"{self.tr.title} - {app_name}","help")
+            self.title_cache[target] = self.tr.title
+        else:
+            self.set_title(f"{self.get_title(self.current_topic)} - {app_name}","help")
+        self.update_history()
+
+    def update_text_buffer(self):
+        if not self.tr:
+            self.tr = text_region.TextRegion(0,0,100,100)
+            self.tr.set_line_height(18)
+            self.tr.base_dir = '/usr/share/help/'
+            self.tr.set_richtext(self.get_document_text(),html=self.is_html())
+            self.text_scroller.tr = self.tr
+
+        if self.size_changed:
+            self.text_scroller.update(self.width - self.decorator.width())
+
+        #self.tr.scroll = self.scroll_offset
+        #self.tr.draw(self.text_buffer)
+
+    def draw(self):
+        surface = self.get_cairo_surface()
+
+        WIDTH, HEIGHT = self.width - self.decorator.width(), self.height - self.decorator.height()
+
+        ctx = cairo.Context(surface)
+        ctx.translate(self.decorator.left_width(), self.decorator.top_height())
+        ctx.rectangle(0,0,WIDTH,HEIGHT)
+        #ctx.set_source_rgb(204/255,204/255,204/255)
+        ctx.set_source_rgb(1,1,1)
+        ctx.fill()
+
+        ctx.save()
+        ctx.translate(0,self.menubar.height)
+        """
+        text = self.text_buffer.get_cairo_surface()
+        ctx.set_source_surface(text,0,-self.text_offset)
+        ctx.paint()
+        """
+        self.text_scroller.draw(ctx,0,0,HEIGHT-self.menubar.height,self.text_offset)
+        ctx.restore()
+
+        self.menubar.draw(ctx,0,0,WIDTH)
+
+        self.decorator.render(self)
+        self.flip()
+
+    def finish_resize(self, msg):
+        """Accept a resize."""
+        if msg.width < 100 or msg.height < 100:
+            self.resize_offer(max(msg.width,100),max(msg.height,100))
+            return
+
+        self.resize_accept(msg.width, msg.height)
+        self.reinit()
+        self.size_changed = True
+        self.update_text_buffer()
+        self.draw()
+        self.resize_done()
+        self.flip()
+
+    def scroll(self, amount):
+        self.text_offset += amount
+        if self.text_offset < 0:
+            self.text_offset = 0
+        if self.text_offset > self.text_scroller.scroll_max():
+            self.text_offset = self.text_scroller.scroll_max()
+
+    def text_under_cursor(self, msg):
+        """Get the text unit under the cursor."""
+        x = msg.new_x - self.decorator.left_width()
+        y = msg.new_y - self.decorator.top_height() + self.text_offset - self.menubar.height
+        return self.tr.click(x,y)
+
+
+    def go_page(self, action):
+        """Navigate to a page."""
+        self.navigate(action)
+        self.draw()
+
+    def go_back(self,action):
+        """Go back."""
+        if self.history and self.history_index > 0:
+            self.history_index -= 1
+            self.navigate(self.history[self.history_index], touch_history=False)
+            self.update_history()
+        self.draw()
+
+    def go_forward(self,action):
+        """Go forward."""
+        if self.history and self.history_index < len(self.history)-1:
+            self.history_index += 1
+            self.navigate(self.history[self.history_index], touch_history=False)
+            self.update_history()
+        self.draw()
+
+    def mouse_event(self, msg):
+        if self.mouse_check(msg):
+            self.draw()
+
+    def mouse_check(self, msg):
+        if d.handle_event(msg) == yutani.Decor.EVENT_CLOSE:
+            window.close()
+            sys.exit(0)
+        x,y = msg.new_x - self.decorator.left_width(), msg.new_y - self.decorator.top_height()
+        w,h = self.width - self.decorator.width(), self.height - self.decorator.height()
+        if x >= 0 and x < w and y >= 0 and y < self.menubar.height:
+            self.menubar.mouse_event(msg, x, y)
+
+        if x >= 0 and x < w and y >= self.menubar.height and y < h:
+            if msg.buttons & yutani.MouseButton.BUTTON_RIGHT:
+                if not self.menus:
+                    menu_entries = [
+                        MenuEntryAction("Back","back",self.go_back,None),
+                        MenuEntryAction("Forward","forward",self.go_forward,None),
+                    ]
+                    menu = MenuWindow(menu_entries,(self.x+msg.new_x,self.y+msg.new_y),root=self)
+            if msg.buttons & yutani.MouseButton.SCROLL_UP:
+                self.scroll(-30)
+                return True
+            elif msg.buttons & yutani.MouseButton.SCROLL_DOWN:
+                self.scroll(30)
+                return True
+            if msg.command == yutani.MouseEvent.DOWN:
+                e = self.text_under_cursor(msg)
+                r = False
+                if self.down_text and e != self.down_text:
+                    for u in self.down_text.tag_group:
+                        if u.unit_type == 4:
+                            u.set_extra('hilight',False)
+                        else:
+                            u.set_font(self.down_font[u])
+                    del self.down_font
+                    self.down_text = None
+                    self.update_text_buffer()
+                    r = True
+                if e and 'link' in e.extra and e.tag_group:
+                    self.down_font = {}
+                    for u in e.tag_group:
+                        if u.unit_type == 4:
+                            u.set_extra('hilight',True)
+                        else:
+                            new_font = toaru_fonts.Font(u.font.font_number,u.font.font_size,0xFFFF0000)
+                            self.down_font[u] = u.font
+                            u.set_font(new_font)
+                    self.update_text_buffer()
+                    r = True
+                    self.down_text = e
+                else:
+                    self.down_text = None
+                return r
+            if msg.command == yutani.MouseEvent.CLICK or msg.command == yutani.MouseEvent.RAISE:
+                e = self.text_under_cursor(msg)
+                if self.down_text and e == self.down_text:
+                    self.navigate(e.extra['link'])
+                    return True
+                elif self.down_text:
+                    for u in self.down_text.tag_group:
+                        if u.unit_type == 4:
+                            u.set_extra('hilight',False)
+                        else:
+                            u.set_font(self.down_font[u])
+                    del self.down_font
+                    self.down_text = None
+                    self.update_text_buffer()
+                    return True
+
+        return False
+
+    def keyboard_event(self, msg):
+        if self.keyboard_check(msg):
+            self.draw()
+
+    def keyboard_check(self,msg):
+        if msg.event.action != 0x01:
+            return False # Ignore anything that isn't a key down.
+        if msg.event.keycode == yutani.Keycode.HOME:
+            self.text_offset = 0
+            return True
+        elif msg.event.keycode == yutani.Keycode.END:
+            n = (len(self.tr.lines)-self.tr.visible_lines())+5
+            self.text_offset = self.text_scroller.scroll_max()
+            return True
+        elif msg.event.keycode == yutani.Keycode.PAGE_UP:
+            self.scroll(int(-self.height/2))
+            return True
+        elif msg.event.keycode == yutani.Keycode.PAGE_DOWN:
+            self.scroll(int(self.height/2))
+            return True
+        elif msg.event.key == b"q":
+            self.close()
+            sys.exit(0)
+
+if __name__ == '__main__':
+    yutani.Yutani()
+    d = yutani.Decor()
+
+    window = HelpBrowserWindow(d)
+
+    if len(sys.argv) > 1:
+        window.navigate(sys.argv[-1])
+
+    window.draw()
+
+    yutani_mainloop.mainloop()

+ 10 - 2
util/python-demos/text_region.py

@@ -8,6 +8,12 @@ import os
 
 import cairo
 import toaru_fonts
+import yutani
+
+def create_from_bmp(path):
+    if os.path.exists(path) and path.endswith('.bmp'):
+        return yutani.Sprite.from_file(path).get_cairo_surface()
+    return None
 
 _emoji_available = os.path.exists('/usr/share/emoji')
 
@@ -417,7 +423,9 @@ class TextRegion(object):
                         img = self.img_from_path(target)
                     except:
                         print(f"Failed to load image {target}, going to show backup image.")
-                        img = self.img_from_path('/usr/share/icons/16/missing.png')
+                        img = None
+                    if not img:
+                        img = self.img_from_path('/usr/share/icons/16/missing.bmp')
                     chop = math.ceil(img.get_height() / tr.line_height)
                     group = []
                     for i in range(chop):
@@ -449,7 +457,7 @@ class TextRegion(object):
 
             def img_from_path(self, path):
                 if not path in self.surface_cache:
-                    s = cairo.ImageSurface.create_from_png(path)
+                    s = create_from_bmp(path)
                     self.surface_cache[path] = s
                     return s
                 else: