[Geany] feature request: expand text view

[John Gabriele]

On 5/4/07, Enrico Tröger <enrico.troeger at uvena.de> wrote:
> On Mon, 30 Apr 2007 14:12:26 -0400, "John Gabriele" <jmg3000 at gmail.com>
> wrote:
>
> > One thing about IDE's is how much screen real estate gets taken up by
> > various windows and toolbars. Often, when editing a single file, I
> > wish I had more room on the screen for the text (specifically, more
> > vertical lines displayed at once).
> >
> > I see that in Geany, under the View menu, I can toggle the following:
> >
> > * message window
> > * toolbar
> >
> > and in Edit --> Prefs --> Interface tab:
> >
> > * Misc section, I can toggle the statusbar on and off.
> > * Tab placement, I can shut off editor tabs.
> >
> > Now, what would be darn cool is if there were a menu item under View
> > (critical: and a key combo to go with it) to allow me to toggle all
> > four of those off in one fell swoop. I need the message window,
> > toolbar, statusbar, and editor tabs -- just not all the time.
> I added a keybinding(no menu item, at least not now) to hide most of
> the additional widgets. We don't hide the notebook tabs because then
> you loose control(mostly) over open files and can only switch with
> keyboard shortcuts between the files.
>
> Default shortcut is unset.
>
> Added in SVN r1505.
>
> Regards,
> Enrico

Neat. Thanks. :) I stuck in on the F12 key. Interesting choice of
hiding the sidebar instead of the tabs. Just curious: why hide the
sidebar at all? Do you often need the extra text window *width*?

Say, I went to make some updates to the docs (mostly regarding this),
but noticed that there seemed to be some issues after running `make
doc` in the geany/doc directory

=== snip ===
$ make doc
if [ geany.docbook -nt "./html/index.html" ]; then \
                /bin/sh ../mkinstalldirs html; \
                xmlto -m geany.xsl -o html/ xhtml ./geany.docbook; \
                test -f html/geany.css || cp ./geany.css html/; \
        fi
xmlto: input does not validate (status 1)
/home/john/opt/src/geany/doc/./geany.docbook:1354: parser error :
Opening and ending tag mismatch: para line 1127 and section
                </section>
                          ^
/home/john/opt/src/geany/doc/./geany.docbook:2006: parser error :
Opening and ending tag mismatch: section line 1108 and chapter
        </chapter>
                  ^
/home/john/opt/src/geany/doc/./geany.docbook:2699: parser error :
Opening and ending tag mismatch: chapter line 186 and book
</book>
       ^
/home/john/opt/src/geany/doc/./geany.docbook:2700: parser error :
Premature end of data in tag book line 13

^
=== /snip ===

I didn't touch those lines, so I'm not sure why those errors are
showing up now, but please find attached my small patch/addition.

---John
-------------- next part --------------
Index: geany.docbook
===================================================================
--- geany.docbook	(revision 1505)
+++ geany.docbook	(working copy)
@@ -1108,40 +1108,83 @@
 		<section id="confdialog">
 			<title>Preferences</title>
 			<para>
+				You may adjust Geany's settings using the Edit --> Preferences dialog. Any
+				changes you make there can be applied by hitting either the Apply or the Ok
+				button. These settings will persist between Geany sessions. Note that most
+				settings here have descriptive popup bubble help -- just hover the mouse
+				over the item in question to get help on it.
+			</para>
+			<para>
+				You may also adjust some View settings (under the View menu) that persist
+				between Geany sessions. The settings under the Document menu, however, are
+				only for the current document and revert to defaults when restarting Geany.
+			</para>
+			<para>
+				Note, in the paragraphs that follow, the text describing a dialog tab
+				(if present) comes after the screenshot of that tab.
+			</para>
+
+			<para>
 				<!-- should be written -->
 				<!-- I know that <mediaobject> is better than <graphic> but <mediaobject> does not work with PDF -->
+			<para>
 				<figure id="confdialog_gen">
 				   <title>General tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_gen.png"></graphic>
 				</figure>
+				<emphasis>The "Context Activation" setting needs to be documented.</emphasis>
+			</para>
+			<para>
 				<figure>
 				   <title>Interface tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_interface.png"></graphic>
 				</figure>
+				The open files list and the editor tabs are two different ways to switch
+				between documents using the mouse. When you hit the key combination to
+				move between tabs, the order is determined by the tab order, not alphabetical
+				as shown in the open files list (regardless whether or not editor tabs are
+				visible).
+			</para>
+			<para>
 				<figure>
 				   <title>Toolbar tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_toolbar.png"></graphic>
 				</figure>
+			</para>
+			<para>
 				<figure>
 				   <title>Files tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_files.png"></graphic>
 				</figure>
+			</para>
+			<para>
 				<figure>
 				   <title>Editor tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_edit.png"></graphic>
 				</figure>
+				Line wrapping refers to the display of the text in the editor. Currently,
+				there is no setting to have Geany automatically insert newlines into your
+				document while you type.
+			</para>
+			<para>
 				<figure>
 				   <title>Tools tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_tools.png"></graphic>
 				</figure>
+			</para>
+			<para>
 				<figure id="confdialog_templ">
 				   <title>Template tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_templ.png"></graphic>
 				</figure>
+			</para>
+			<para>
 				<figure id="confdialog_keys">
 				   <title>Keybinding tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_keys.png"></graphic>
 				</figure>
+			</para>
+			<para>
 			   <note>
 					<para>For more information see <xref linkend="keybindings"/>.</para>
 			   </note>
@@ -1149,6 +1192,9 @@
 				   <title>VTE tab in preferences dialog</title>
 				   <graphic fileref="images/pref_dialog_vte.png"></graphic>
 				</figure>
+				There are some handy commands in here that are not, by default, bound to a key
+				combination, and may in fact not even be available as a menu item (for example, the
+				very handy "Hide and show all additional widgets").
 			</para>
 			<section id="cto">
 				<title>Compile time options</title>
@@ -1726,6 +1772,10 @@
 								<entry>Zooms out the text</entry>
 							</row>
 							<row>
+								<entry>Hide and show all additional widgets</entry>
+								<entry>Toggles text area of the IDE to take up the whole window.</entry>
+							</row>
+							<row>
 								<entry>Replace tabs by space</entry>
 								<entry>Replaces all tabs with the right amount of spaces.</entry>
 							</row>