/usr/share/doc/libghc-glib-doc/html/src/System-Glib-Utils.html is in libghc-glib-doc 0.12.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ -->
<title>dist-ghc/build/System/Glib/Utils.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>-- GENERATED by C->Haskell Compiler, version 0.13.5 (gtk2hs branch) "Bin IO", 13 Nov 2004 (Haskell)</span>
<a name="line-2"></a><span class='hs-comment'>-- Edit the ORIGNAL .chs file instead!</span>
<a name="line-3"></a>
<a name="line-4"></a>
<a name="line-5"></a><span class='hs-comment'>{-# LINE 1 "./System/Glib/Utils.chs" #-}</span>
<a name="line-6"></a><span class='hs-comment'>-- -*-haskell-*-</span>
<a name="line-7"></a><span class='hs-comment'>-- GIMP Toolkit (GTK) Miscellaneous utilities</span>
<a name="line-8"></a><span class='hs-comment'>--</span>
<a name="line-9"></a><span class='hs-comment'>-- Author : John Millikin</span>
<a name="line-10"></a><span class='hs-comment'>--</span>
<a name="line-11"></a><span class='hs-comment'>-- Created: 15 November 2009</span>
<a name="line-12"></a><span class='hs-comment'>--</span>
<a name="line-13"></a><span class='hs-comment'>-- Copyright (C) 2009 John Millikin</span>
<a name="line-14"></a><span class='hs-comment'>--</span>
<a name="line-15"></a><span class='hs-comment'>-- This library is free software; you can redistribute it and/or</span>
<a name="line-16"></a><span class='hs-comment'>-- modify it under the terms of the GNU Lesser General Public</span>
<a name="line-17"></a><span class='hs-comment'>-- License as published by the Free Software Foundation; either</span>
<a name="line-18"></a><span class='hs-comment'>-- version 2.1 of the License, or (at your option) any later version.</span>
<a name="line-19"></a><span class='hs-comment'>-- </span>
<a name="line-20"></a><span class='hs-comment'>-- This library is distributed in the hope that it will be useful,</span>
<a name="line-21"></a><span class='hs-comment'>-- but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="line-22"></a><span class='hs-comment'>-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="line-23"></a><span class='hs-comment'>-- Lesser General Public License for more details.</span>
<a name="line-24"></a><span class='hs-comment'>--</span>
<a name="line-25"></a><span class='hs-comment'>-- |</span>
<a name="line-26"></a><span class='hs-comment'>-- Maintainer : gtk2hs-users@lists.sourceforge.net</span>
<a name="line-27"></a><span class='hs-comment'>-- Stability : provisional</span>
<a name="line-28"></a><span class='hs-comment'>-- Portability : portable (depends on GHC)</span>
<a name="line-29"></a><span class='hs-comment'>--</span>
<a name="line-30"></a><span class='hs-comment'>-- This module binds GLib-specific utility procedures.</span>
<a name="line-31"></a><span class='hs-comment'>--</span>
<a name="line-32"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>Utils</span>
<a name="line-33"></a> <span class='hs-layout'>(</span> <span class='hs-varid'>getApplicationName</span>
<a name="line-34"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>setApplicationName</span>
<a name="line-35"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>getProgramName</span>
<a name="line-36"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>setProgramName</span>
<a name="line-37"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-38"></a>
<a name="line-39"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>FFI</span>
<a name="line-40"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Glib</span><span class='hs-varop'>.</span><span class='hs-conid'>UTFString</span>
<a name="line-41"></a>
<a name="line-42"></a>
<a name="line-43"></a><span class='hs-comment'>{-# LINE 37 "./System/Glib/Utils.chs" #-}</span>
<a name="line-44"></a>
<a name="line-45"></a><a name="getApplicationName"></a><span class='hs-comment'>-- |</span>
<a name="line-46"></a><span class='hs-comment'>-- Gets a human-readable name for the application, as set by</span>
<a name="line-47"></a><span class='hs-comment'>-- 'setApplicationName'. This name should be localized if possible, and is</span>
<a name="line-48"></a><span class='hs-comment'>-- intended for display to the user. Contrast with 'getProgramName', which</span>
<a name="line-49"></a><span class='hs-comment'>-- gets a non-localized name. If 'setApplicationName' has not been performed,</span>
<a name="line-50"></a><span class='hs-comment'>-- returns the result of 'getProgramName' (which may be 'Nothing' if</span>
<a name="line-51"></a><span class='hs-comment'>-- 'setProgramName' has also not been performed).</span>
<a name="line-52"></a><span class='hs-comment'>--</span>
<a name="line-53"></a><span class='hs-definition'>getApplicationName</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-conid'>String</span><span class='hs-layout'>)</span>
<a name="line-54"></a><span class='hs-definition'>getApplicationName</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>g_get_application_name</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>maybePeek</span> <span class='hs-varid'>peekUTFString</span>
<a name="line-55"></a>
<a name="line-56"></a><a name="setApplicationName"></a><span class='hs-comment'>-- |</span>
<a name="line-57"></a><span class='hs-comment'>-- Sets a human-readable name for the application. This name should be</span>
<a name="line-58"></a><span class='hs-comment'>-- localized if possible, and is intended for display to the user. Contrast</span>
<a name="line-59"></a><span class='hs-comment'>-- with 'setProgramName', which sets a non-localized name. 'setProgramName'</span>
<a name="line-60"></a><span class='hs-comment'>-- will be performed automatically by 'initGUI', but 'setApplicationName'</span>
<a name="line-61"></a><span class='hs-comment'>-- will not.</span>
<a name="line-62"></a><span class='hs-comment'>--</span>
<a name="line-63"></a><span class='hs-comment'>-- Note that for thread safety reasons, this computation can only be performed</span>
<a name="line-64"></a><span class='hs-comment'>-- once.</span>
<a name="line-65"></a><span class='hs-comment'>--</span>
<a name="line-66"></a><span class='hs-comment'>-- The application name will be used in contexts such as error messages, or</span>
<a name="line-67"></a><span class='hs-comment'>-- when displaying an application's name in the task list.</span>
<a name="line-68"></a><span class='hs-comment'>--</span>
<a name="line-69"></a><span class='hs-definition'>setApplicationName</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-70"></a><span class='hs-definition'>setApplicationName</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-varid'>withUTFString</span> <span class='hs-varid'>g_set_application_name</span>
<a name="line-71"></a><span class='hs-comment'>{-# LINE 64 "./System/Glib/Utils.chs" #-}</span>
<a name="line-72"></a>
<a name="line-73"></a><a name="getProgramName"></a><span class='hs-comment'>-- |</span>
<a name="line-74"></a><span class='hs-comment'>-- Gets the name of the program. This name should /not/ be localized, contrast</span>
<a name="line-75"></a><span class='hs-comment'>-- with 'getApplicationName'. If you are using GDK or GTK+, the program name</span>
<a name="line-76"></a><span class='hs-comment'>-- is set in 'initGUI' to the last component of argv[0].</span>
<a name="line-77"></a><span class='hs-comment'>--</span>
<a name="line-78"></a><span class='hs-definition'>getProgramName</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Maybe</span> <span class='hs-conid'>String</span><span class='hs-layout'>)</span>
<a name="line-79"></a><span class='hs-definition'>getProgramName</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>g_get_prgname</span> <span class='hs-varop'>>>=</span> <span class='hs-varid'>maybePeek</span> <span class='hs-varid'>peekUTFString</span>
<a name="line-80"></a>
<a name="line-81"></a><a name="setProgramName"></a><span class='hs-comment'>-- |</span>
<a name="line-82"></a><span class='hs-comment'>-- Sets the name of the program. This name should /not/ be localized, contrast</span>
<a name="line-83"></a><span class='hs-comment'>-- with 'setApplicationName'. Note that for thread-safety reasons this</span>
<a name="line-84"></a><span class='hs-comment'>-- computation can only be performed once.</span>
<a name="line-85"></a><span class='hs-comment'>--</span>
<a name="line-86"></a><span class='hs-definition'>setProgramName</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>String</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-conid'>()</span>
<a name="line-87"></a><span class='hs-definition'>setProgramName</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-varid'>withUTFString</span> <span class='hs-varid'>g_set_prgname</span>
<a name="line-88"></a><span class='hs-comment'>{-# LINE 80 "./System/Glib/Utils.chs" #-}</span>
<a name="line-89"></a>
<a name="line-90"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"g_get_application_name"</span>
<a name="line-91"></a> <span class='hs-varid'>g_get_application_name</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CChar</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-92"></a>
<a name="line-93"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"g_set_application_name"</span>
<a name="line-94"></a> <span class='hs-varid'>g_set_application_name</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CChar</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-95"></a>
<a name="line-96"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"g_get_prgname"</span>
<a name="line-97"></a> <span class='hs-varid'>g_get_prgname</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CChar</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-98"></a>
<a name="line-99"></a><span class='hs-keyword'>foreign</span> <span class='hs-keyword'>import</span> <span class='hs-keyword'>ccall</span> <span class='hs-keyword'>unsafe</span> <span class='hs-str'>"g_set_prgname"</span>
<a name="line-100"></a> <span class='hs-varid'>g_set_prgname</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conid'>Ptr</span> <span class='hs-conid'>CChar</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>IO</span> <span class='hs-conid'>()</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
</pre></body>
</html>
|