diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/architecture.txt | 4 | ||||
| -rw-r--r-- | docs/dnd.txt | 16 | ||||
| -rw-r--r-- | docs/key_mouse_navigation.txt | 4 | ||||
| -rw-r--r-- | docs/reference/libcaja-extension/libcaja-extension-docs.xml | 2 |
4 files changed, 13 insertions, 13 deletions
diff --git a/docs/architecture.txt b/docs/architecture.txt index bda3397e..896bb6ae 100644 --- a/docs/architecture.txt +++ b/docs/architecture.txt @@ -65,7 +65,7 @@ it displays. The CajaWindow object provides various chrome and uses a number of CajaView objects to communicate with view components. The relationship between CajaWindow and the CajaViews is mostly, but not completely one-way; primarily, the -window calls the view's methods and connects to its signals. +window calls the view's methods and connects to its signals. The CajaView object serves as a proxy for a view component. It provides a number of methods which correspond to the methods of the @@ -140,7 +140,7 @@ architecture is different. * Other Communication The Caja:View and Caja:ViewFrame interfaces allow for other -communication as well. +communication as well. The view may request that the frame update the status message, indicate a certain level of progress during loading, or display a diff --git a/docs/dnd.txt b/docs/dnd.txt index 91467f33..0c604f53 100644 --- a/docs/dnd.txt +++ b/docs/dnd.txt @@ -24,13 +24,13 @@ If you are a destination: if you are a source, you have to start a drag trough gtk_drag_begin. This will call drag_begin signal in the source. -Then, when the destination calls gtk_drag_finish, drag_end will be +Then, when the destination calls gtk_drag_finish, drag_end will be called in the source. -drag_get_data will be called in the source when the destination +drag_get_data will be called in the source when the destination calls gtk_drag_get_data -So, the source is very easy to write: it just needs to implement +So, the source is very easy to write: it just needs to implement those 3 signals and it should not have any memory management issue. @@ -38,14 +38,14 @@ those 3 signals and it should not have any memory management issue. -------------- Things get a little bit complicated. -when the dragging cursor gets in your window, you will get drag_motion +when the dragging cursor gets in your window, you will get drag_motion events. In caja, we do many things in this function: - we start auto-scrolling if it is necessary. - we call caja_*_ensure_data - we prelight what is under the cursor if it can accept the drag. - we try to expand what is under you if it can accept the drop (tree view) -caja_*_ensure_data is vital. It calls gtk_drag_get_data to get the +caja_*_ensure_data is vital. It calls gtk_drag_get_data to get the data from the source. this allows the destination to store it in advance and use it to know if what is under the cursor can accept the drag. @@ -57,7 +57,7 @@ Also, just before the drag_drop event, a drag_leave event is triggered. If no drop occurs, a drag_leave occurs. -So, drag_data_received does 2 things: it is called to get the data when we are +So, drag_data_received does 2 things: it is called to get the data when we are in motion and store it. It is also called to do the actual drop operation when a drop happened. @@ -73,12 +73,12 @@ This schema involves careful memory management: To solve 1), we should use ONE destroy function which cleans up the drag data. To solve 2), we have to be very careful where we call this fution from. -This function has to clean up: +This function has to clean up: - the list of expanded nodes (tree view). - the autoscroll code. - the prelighting code. It also has to set drag_info->need_to_destroy to TRUE - so that during the next drag in this widget, the + so that during the next drag in this widget, the rest of the drag data is destroyed before begening the actual new drag. diff --git a/docs/key_mouse_navigation.txt b/docs/key_mouse_navigation.txt index d111f43e..30861609 100644 --- a/docs/key_mouse_navigation.txt +++ b/docs/key_mouse_navigation.txt @@ -19,7 +19,7 @@ Tab - moves to the "next" icon in order (i.e. at the end of one row, Shift Tab - moves to the "previous" icon in order Home - moves to the first icon End - moves to the last icon - + In order to allow multiple selection the above navigation keys can be combined with the Control key to move the keyboard focus without affecting the current selection. If you use normal movement (not using @@ -38,7 +38,7 @@ are selected. In manual layout (and especially, on the desktop) the keyboard arrow keys work in a slightly different way. To allow all icons to be reached the closest icon in the quadrant of the direction selected -will be used as the "next" icon when navigating. +will be used as the "next" icon when navigating. Other keyboard shortcuts: diff --git a/docs/reference/libcaja-extension/libcaja-extension-docs.xml b/docs/reference/libcaja-extension/libcaja-extension-docs.xml index b0b6cf03..777a846d 100644 --- a/docs/reference/libcaja-extension/libcaja-extension-docs.xml +++ b/docs/reference/libcaja-extension/libcaja-extension-docs.xml @@ -1,5 +1,5 @@ <?xml version="1.0"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ <!ENTITY version SYSTEM "version.xml"> ]> |