hasufell/hsfm
1
1
Fork 0
Code Issues 33 Pull Requests Releases Wiki Activity

HACKING: fix links

Browse Source
This commit is contained in:
Julian Ospald 2016-04-17 01:34:49 +02:00
parent 69e417cf19
commit 454f64d410
No known key found for this signature in database
GPG Key ID: 511B62C09D50CD28
1 changed files with 14 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
hacking/HACKING.md
View File

@ -11,7 +11,7 @@ Coding style
- no overcomplicated pointfree style
- normal indenting 2 whitespaces
- just make things pretty and readable
- use the provided [hsimport.hs](hacking/hsimport.hs)
- use the provided [hsimport.hs](hsimport.hs)
Documentation
-------------
@ -22,32 +22,33 @@ Hacking Guide
-------------
The main data structure for the IO related File type is in
[HSFM.FileSystem.FileType](src/HSFM/FileSystem/FileType.hs), which
[HSFM.FileSystem.FileType](../src/HSFM/FileSystem/FileType.hs#L93), which
should be seen as a library. This is the entry point where
directory contents are read and the File type in general is constructed.
[directory contents are read](../src/HSFM/FileSystem/FileType.hs#L465)
and the File type in general [is constructed](../src/HSFM/FileSystem/FileType.hs#L302).
The File type uses a safe Path type under the hood instead of Strings,
utilizing the [hpath](https://github.com/hasufell/hpath) library.
File operations (like copy, delete etc) are defined at
[HSFM.FileSystem.FileOperation](src/HSFM/FileSystem/FileOperations.hs)
[HSFM.FileSystem.FileOperation](../src/HSFM/FileSystem/FileOperations.hs)
which use this File type.
Only a GTK GUI is currently implemented, the entry point being
[HSFM.GUI.Gtk](src/HSFM/GUI/Gtk.hs). From there it flows down
to creating a [MyGUI object](src/HSFM/GUI/Gtk/Data.hs#L51) in
[HSFM.GUI.Gtk.MyGUI](src/HSFM/GUI/Gtk/MyGUI.hs), which is sort of
[HSFM.GUI.Gtk](../src/HSFM/GUI/Gtk.hs). From there it flows down
to creating a [MyGUI object](../src/HSFM/GUI/Gtk/Data.hs#L51) in
[HSFM.GUI.Gtk.MyGUI](../src/HSFM/GUI/Gtk/MyGUI.hs), which is sort of
a global object for the whole window. Inside this object are
theoretically multiple [MyView objects](src/HSFM/GUI/Gtk/Data.hs#L101)
theoretically multiple [MyView objects](../src/HSFM/GUI/Gtk/Data.hs#L101)
allowed which represent the actual view on the filesystem and related
widgets, which are constructed in
[HSFM.GUI.Gtk.MyView](src/HSFM/GUI/Gtk/MyView.hs). Both MyGUI and MyView
[HSFM.GUI.Gtk.MyView](../src/HSFM/GUI/Gtk/MyView.hs). Both MyGUI and MyView
are more or less accessible throughout the whole GTK callstack, expclicitly
passed as parameters.
For adding new GTK widgets with functionality you mostly have to touch the
following files:
* [builder.xml](data/Gtk/builder.xml): this defines the main GUI widgets which are static, use the [glade editor](http://glade.gnome.org) to add stuff
* [HSFM.GUI.Gtk.Data](src/HSFM/GUI/Gtk/Data.hs): add the widget to e.g. the MyGUI type so we can access it throughout the GTK call stack
* [HSFM.GUI.Gtk.MyGUI](src/HSFM/GUI/Gtk/MyGUI.hs): add initializers for the GUI buttons to be fetched from the GTK builder.xml file
* [HSFM.GUI.Gtk.Callbacks](src/HSFM/GUI/Gtk/Callbacks.hs): define the callbacks and the actual functionality here
* [builder.xml](../data/Gtk/builder.xml): this defines the main GUI widgets which are static, use the [glade editor](http://glade.gnome.org) to add stuff
* [HSFM.GUI.Gtk.Data](../src/HSFM/GUI/Gtk/Data.hs): add the widget to e.g. the MyGUI type so we can access it throughout the GTK call stack
* [HSFM.GUI.Gtk.MyGUI](../src/HSFM/GUI/Gtk/MyGUI.hs): add initializers for the GUI buttons to be fetched from the GTK builder.xml file
* [HSFM.GUI.Gtk.Callbacks](../src/HSFM/GUI/Gtk/Callbacks.hs): define the callbacks and the actual functionality here