~ubuntu-branches/ubuntu/maverick/conglomerate/maverick

 * @doc: The #CongDocument upon which the command is to act.

 * @description: Human-readable, translated name for this command, as it will appear in the undo/redo history

 * widget

 * @consolidation_id: A string ID (or NULL) for this command to allow multiple similar commands to be consolidated into 

 * a single command.  For example, multiple characters being typed at the keboard can be merged into a single "Typing" command.

 * 

 * Should only be called by the internals of #CongDocument; if you wish to create a #CongCommand you should call cong_document_begin_command()

 * instead.

 *

 * Returns:  the new #CongCommand

 *

 * @command: a command

 * Returns: the human-readable description of this command

 * @command:  The relevant #CongCommand 

 *

 * Gets the ID (or NULL) of the command used for consolidating multiple similar operations into a single entry in the undo/redo history

 *

 * Returns: a constant string, or NULL if no merging is to occur

 * @command: a command

 * Undoes the command.  All modifications contained within the command are undone from the document (in reverse order), the document's "is-modified" flag is set to whatever it was when the command was created.

        /* g_message ("cong_command_undo(\"%s\")", cong_command_get_description(command)); */

 * Redoes a command that has previously been undone.  Replays all the modifications on the document in order from start to finish.

        /* g_message ("cong_command_redo(\"%s\")", cong_command_get_description(command)); */

 * cong_command_merge: *

 * @dst: The #CongCommand into which the modifications are to be added

 * @src: The #CongCommand from which the modifications are to be taken

 *

 * Takes all of the modifications from @src and places them on the end of @dst.  Only to be used by the internals of the undo/redo management

 *

/**

 * cong_command_has_ever_been_undone: *

 * @cmd:

 *

 * A function used by the command consolidation/merging system.  If you undo then redo a command,

 * further similar operations should get separate entries in the undo/redo histroy, rather than being

 * merged.

 *

 * Returns: A #gboolean, answering the question "has this command ever been undone?"

 */

                                const gchar *new_content)

                                     const gchar *name, 

                                     const gchar *value)

                                        const gchar *name)

 * @range: a range within the document; both start and end must have the same parent, so that proper nesting is maintained

 *

 * Utility function to add a series of modifications to the given command.

 *

 * Deletes the given range within the document (can include multiple nodes).  Updates cursor and selection accordingly.

                                gchar *text_before = g_strndup ((gchar*)loc0.node->content, loc0.byte_offset);

 * Utility function to add a series of modifications to the given command.

 *

 * Deletes the current selection within the document, updating cursor and selection accordingly.

 * @string: a UTF-8 string

 *

 * Utility function to add a series of modifications to the given command.

 *

 * Inserts the given text at the cursor, moving the cursor to the end of the inserted text.

        gchar *initial_part;

        gchar *new_content;

        initial_part = g_strndup ((const gchar*)old_cursor_loc.node->content, old_cursor_loc.byte_offset);

        CONG_VALIDATE_UTF8(initial_part);

 

        CONG_VALIDATE_UTF8((const gchar*)old_cursor_loc.node->content+old_cursor_loc.byte_offset);

 

        new_content = g_strconcat (initial_part,

                                   string, 

                                   (const gchar*)old_cursor_loc.node->content+old_cursor_loc.byte_offset, 

                                   NULL);

        CONG_VALIDATE_UTF8(new_content);

        g_free (initial_part);

        g_free (new_content);

        new_cursor_loc.byte_offset += byte_length;

        CONG_VALIDATE_UTF8((const gchar*)new_cursor_loc.node->content+new_cursor_loc.byte_offset);

                gchar* new_text = g_strndup((const gchar*)loc->node->content, len1);

                d = cong_node_new_textual_len (node_type, cong_node_safe_get_content(loc->node) + len1, len2, doc); /* FIXME: check char ptr arithmetic; UTF8? */

                location->byte_offset += strlen((const char*)affected_node->prev->content);

 * Utility function to add a series of modifications to the given command.

 * 

 * Searches the entire document, looking for text nodes adjacent to other text nodes, merging them together.

 * Utility function to add a series of modifications to the given command.

 * 

 * Searches direct children of the given node, looking for text nodes adjacent to other text nodes, merging them together.

 * Utility function to add a series of modifications to the given command.

 * 

 * Splits the selected nodes as necessary and adds as a child of the input node

 *

 * Utility function to add a series of modifications to the given command.

 *

 * Splits a text or comment node into 3 nodes, and returns a pointer to the middle one

 *

 * Returns: the middle node of the three newly-created nodes

        d1 = cong_node_new_textual_len (node_type, cong_node_safe_get_content(node), len1, doc); /* FIXME:  audit the char types here, and the char pointer arithmetic. UTF8? */

        d2 = cong_node_new_textual_len (node_type, cong_node_safe_get_content(node) + len1, len2, doc);

        d3 = cong_node_new_textual_len (node_type, cong_node_safe_get_content(node) + len1 + len2, len3, doc);

 * @node: a node

 *

 * Utility function to add a series of modifications to the given command.

 *

 * Removes the given node from the tree, moving all of its children into the space it occupied.

 * @cmd: a command

 * @root_element: the root element of the document

 * Utility function to add a series of modifications to the given command.

 * 

 * Sets an external DTD on the document, or removes it if NULL is given