Gruff Release History

Version 3.1.19

• Fixed: Freetext queries that contain wildcard characters did not work on AllegroGraph 4.x in a remote Gruff on Windows or the Mac.
• Fixed: Sometimes an operation from a pop-up menu such as selecting a certain type of node would claim that there are no nodes of that type the first time you try.
• Fixed: Selecting a node by freetext for an edit in the table view would display the node in the table after it used it for the edit.

Version 3.1.18

• Displaying encoded typed literals whose values are not strings was broken recently, and is now fixed. And encoded literals of type "date" now display a reasonable label for the first time.
• Finding all types and all predicates in the store (for menu choices) is much faster.

Version 3.1.17

A fix for non-string encoded types. A bad bug has been fixed that broke Gruff whenever it displayed a literal node that uses an encoded type whose value is not a string.

Version 3.1.16

• Ubuntu-specific fixes. Two problems that caused Gruff to become very confused on recent releases of Ubuntu have been fixed.
• Reselecting sets of current predicates. The new command "Link | Use a Recent Set of Current Predicates" allows quickly reselecting a set of current predicates that you've used recently in the currently open store.
• Controlling menu width. The new option "Global Options | Maximum Menu String Length" determines the length at which strings on menus will be truncated to avoid overly wide menus.

Version 3.1.15

Controlling Gruff from external software via HTTP. Gruff can now start up an HTTP server and then handle several commands from external software to do things like laying out an arbitrary set of triples, doing queries, and displaying properties in the table view. See the new command "Global Options | Start HTTP Server" and the new documentation section "The HTTP Interface to Gruff" at the end of the single Gruff document.

Version 3.1.14

Fixed: Sometimes the bottom line of a three-line node label in the graph
view was chopped off on the GTK platforms.

Version 3.1.13

Quickly toggling tables between one-text-line-per-property and full
text. The existing option "Table Options | Fit Row Height to Text" now
updates the table immediately, and has a keyboard shortcut for quickly
toggling the view.

Suppressing multiple line styles. The new option "Visual Graph Options
| Node and Link Color for Types | Suppress Link Line Styles" causes all
link lines in the graph view to be drawn in the same way.

Fixed: Clicking in the empty area below the bottom of all table rows was
breaking.

Fixed: The pretty label for a literal contained backslash characters
before any embedded double-quote characters.

Fixed: The editing pop-up menu in the table view showed the reverse
keyboard shortcuts for adding a new row for the same or different
predicate.

Version 3.1.12

Finding paths when using a remote server is much faster. The new
(perhaps temporary) option "Visual Graph Options | Finding Paths Between
Nodes | Find Remote Paths on Server" can be toggled off to compare the
old basic approach with the new faster approach.

The new command "File | Load Triples | Load Turtle" allows loading
triples from a file that's in Turtle format.

Version 3.1.11

Bug fixes

• Fixed the recently broken graphical query view. Some basic things were broken in the graphical query view in the previous release (3.0.8), including simply left-clicking a variable node.
• Fixed saving layouts that include blank nodes. This had worked earlier, but became broken somewhat recently without being noticed.
• Fixed a shrinking pane in the query view. The query string widget in the query view was getting a bit shorter each time Gruff was restarted. That required the user to eventually use the split-bar widget to drag it taller again. The split-bar positions will also now be restored from the previous Gruff session.
• Selecting a node of a predicate in the graphical query view. In the graphical query view, when you select a different non-variable node for a node picture, if a link line for a non-variable predicate is connected to the node picture then there will be a new option to select a subject or object of that predicate as the replacement node.
• Clarifying the term "Label Properties". Various options that had used the expression "Label Properties" now speak of "Label Predicates" instead. This is to avoid the impression that the options are about attributes of labels, when in fact they deal with predicates whose values are used as labels.
• Fixed saving layouts as pixmaps on GTK. On Linux and the Mac, saving a layout as a pixmap had left a blank rectangle in the saved image where the file selection dialog had covered it.

• Shortcut menus in the graph view. There are now right-click pop-up menus in the graph view, as in other views before. There are separate menus when clicking on a node, a link line, or the background. The commands are mostly borrowed from the menu bar.
• Store-editing in the graph view. Triples can now be created, reversed, and deleted in the graph view, rather than only in the table view. The new commands are both on the Edit pull-down menu and on the new pop-up menus for nodes and links. When creating a triple by linking displayed objects, clicking on a second node will create a "regular" triple for the two linked nodes, while clicking on a link line will create a triple that reifies the triple of that link line.
• Reification support in the graph view. The graph view now displays reification intuitively by drawing a link line from a reifying subject node directly to the middle of the link line for the triple that it reifies. Also, if a link line's triple is reified, then a command on its pop-up menu allows you to display a reifying triple. And a triple ID node has a pop-up menu command to replace it with the nodes and link of the triple that it represents.
• More reification support in the table view. Any table row whose triple is reified will display an icon that indicates how many reifying triples it has, and that icon can be clicked to display the reifying triples. Also, when replacing the object of a row with a triple ID node, it will now offer a menu of all of the triple ID nodes that you have copied in the current Gruff session.
• Adding nodes to a relatively large visual graph is faster. Inefficiencies in finding other displayed nodes that are linked by the current predicates were fixed.
• The keyboard shortcut for showing pop-up menus (in all views) is now the M key rather than the N key.
• The command "Link | Display Linked Nodes from a List" had been renamed to "Display Linked Nodes from a Tree" for clarity.
• Namespace abbreviations bug fixed. A recent bad bug was fixed where the global namespace abbreviations were wiped out when opening a store.
• New CSV query output format options. There are two new options for the format of CSV query output, namely "Query Options | CSV File Include Full URIs" and "Query Options | CSV File Include Column Headers".
• Delivering stores that access document files. The new option "Global Options | Document Base Folder" allows specifying relative pathnames of documents as node values, and then passing the store and document files to others who could place the documents into a folder of their own choice and then use Gruff to invoke other programs to view the documents.

• Gruff for AllegroGraph 4 on Windows and Mac. Gruff now works as a remote client on Windows, Mac, and Linux with an AllegroGraph 4.3 server that's running on 64-bit Linux as usual.
• Creating a remote store. The new command File | New Remote Triple-Store allows creating a remote store in Gruff. Previously for a remote store you needed to create it outside of Gruff and then open it in Gruff.
• A cleaner menu bar. Pull-down menus or some of the commands on them are now removed in views where they are not applicable, to decrease the clutter of many menu commands. As part of this, the options menus have been reorganized, grouping options according to the views in which they are available.
• Reification support. There is new support for reification when using either triple-id typed literals (as we suggest) or RDF-style reification. Labels for triple-id nodes and rdf:Statement nodes will mention the three parts of their triples, and a triple-id node that is displayed in the table view will have special rows for the three parts of its triple. You can create reified triples in the table view starting with the new command "Table View Value Column Navigation | Copy Triple ID to Clipboard" (see the documenation). And fancier reification support in the graph view is coming up!
• Freetext enhancements on AllegroGraph 4:
• On AllegroGraph 4, the new command "Display | Current Freetext Index" allows selecting any freetext index to search and/or modify, rather than always using a single index called "gruff". This allows quickly switching between various already-indexed sets of predicates to search. The command also allows creating a new freetext index with some arbitrary name, and the menu of indexes includes an option to delete an index.
• On AllegroGraph 4, the "Display | Edit Freetext Predicates" dialog has additional widgets for specifying options such as whether to index resources (rather than literals only), which triple fields to index, the minimum character length for indexed words, and stop words that are never indexed.
• On AllegroGraph 4, you can now use either the AG 3.3 or 4.x style in a freetext query string that contains a word containing wildcard characters or a phrase with embedded spaces. Previously there was no way to specify a phrase on AG4, and wildcard words did not work when specified as in the example on the dialog.
• Better support for international characters. Non-ASCII characters are now handled when editing values in the table view, and when entering query strings and freetext search expressions. Also, the new option "Drawing Options | Auto Font Switching on Text Entry" controls whether text-editing panes in Gruff automatically switch fonts when needed to draw inserted characters properly, which may be needed for Asian characters especially. (There are also two somewhat related options, Edit | Percent-Decode Characters for Editing and Edit | Percent-Encode Non-ASCII After Editing, though those options are preliminary and still under discussion.)
• Fixed: On Linux or Mac, Gruff could mistakenly believe that the user had immediately aborted certain operations such as clicking on a second node for finding paths, or dragging a new predicate link in the graphical query view, or specifying the selected or ordered variables there. (This happened when Gruff hadn't received a key-up event for the Escape key some time earlier.)
• Fixed: At some point "Link | Display Only Paths Between Two Nodes" stopped pinning the two end nodes at the left and right sides of the window, to stretch out the paths horizontally between them.
• Fixed: "Global Options | Widget Font" did not affect radio buttons and check boxes.
• Fixed: Changing the canvas size in the graphical query view left grouper boxes in the wrong place.
• The graph view reflects table view edits. Whenever a triple is created or edited in the table view, the nodes and link for that triple are now automatically added to the graph view. So now the graph view not only serves as a history of what you've visited in the table view as before, but also as a history of what you've edited in the table view as well.
• The query pane handles resizing Gruff small better.
• Visiting web pages from the query view. You can visit the web page of a node from the query view's results table, as with the table view before. See the right-click pop-up menu.
• No more option to exclude literals. We have removed the Include Literals option, and it now effectively is always true. It was deemed a rather arbitrary distinction that was more potentially confusing than useful.

• Updated to use new Mac OS X GTK+ Framework installation. This new version of Gruff should be much easier to use on Mac OS X installations, due to the GTK installation being much easier to install. It no longer relies on Mac Ports. See the new installation instructions for X11 and GTK for use with Gruff.
• Allow removing namespace abbreviation mappings.
• Stop showing a warning dialog at startup if restriction reasoning is enabled.

• New user option Inclusion Options | Reasoner Enables Restriction Reasoning.

• New store-editing functionality for creating and deleting triples. See the various commands on the new Edit pull-down menu and on the new right-click pop-up menu in the table view. A property value in the table view can be edited in place or replaced with an existing node that you select in one of several ways. You can create or edit an object "by type", where Gruff will add suggested rows to the table for predicates that other objects of the same type have, and for predicates that define that type as their domain or range. Edits can be undone and redone.
• New command File | Extract Triples from an RDFa Web Page. The subset of triples that are extracted can be controlled with the new option Inclusion Options | Ignored RDFa Relationships. This command can be used behind a firewall by using the new option Inclusion Options | HTTP Proxy.
• The table view has a separate shift-right-click menu of navigation commands. The commands have shortcuts for moving around the table with keystrokes.
• Some renaming and moving of commands. The Add menu is now called the Display menu to differentiate it from the new functionality for creating triples. The Table & Query Options menu has been merged into other menus, mostly into a Table View child menu of the Drawing Options menu. Commands on the Link, Remove, Select, and Layout menus that are not specific to the graph view have been moved to other menus, especially the View menu. The former "Undo / Go Back" command is now simply the "Go Back" command, while the new "Undo" command relates to creating and deleting triples.
• New command Display | Display a Recently-Selected Node. This is handy for starting a new Gruff session by displaying one or more nodes that you were using in the previous session for the same store.
• An important fix for URI-encoded (percent-encoded) nodes. When deriving pretty labels for nodes from URIs, percent-encoded characters (%xx) were not handled correctly, leading to garbage characters in node labels.
• Improvements to Drawing Options | Namespace Abbreviations.
• New option Layout Options | Do Automatic Incremental Layouts. This allows suppressing automatic layouts when you have nodes arranged where you want them.
• New option Drawing Options | Table View | Display Literals of All Languages. It defaults to true, which is NOT the old behavior.
• New option Inclusion Options | Finding Paths | Maximum Paths to Display.
• New option Inclusion Options | Confirm Exit.
• Basic Emacs editing keystrokes can be used in the query text widget. Also when editing values in the table view.
• Query results can be written to file as textual tables. See the various new options on the Inclusion Options | Query Options menu and the new Write Text Report button widget in the query view.
• Invoking other programs to display documents. (Windows platform only.) The control-shift-left-click gesture for visiting the web page that a node names will instead invoke a program to display a document if the node value appears to name a non-HTML document file. This will use the program that's registered for that type of file, unless the new option Drawing Options | Table View | Use Web Browser for All Documents is enabled.
• A bad triple-indexing inefficiency is fixed. (This applies to AllegroGraph 3.3 only.) For efficiency, Gruff now indexes only new triples automatically, and provides the new command File | Index All Triples that you could use when you can wait for it.
• You can now generate a bug report for a query error.
• Inclusion Options | Remove Orphans on Node Removal is no longer true by default.
• The documentation has been reorganized.

• New command View | Browse a Single Graph.
• New command Add | Display Triples of One Graph.
• New commands for loading triples from N-Quads and Trix files.
• The new command File | Federate Recent Stores allows browsing a combination of recently-opened stores at one time. And on Agraph4 you can browse a federation of stores that are in the same catalog by specifying multiple store names in the "File | Open Triple-Store" dialog that lists the stores.
• The behind-the-scenes collecting of all predicates, nodes, types, and classes for offering in menus is much faster.
• New option Drawing Options | Link Labels | Draw Link Labels For Node Under Mouse.
• Clicking a node or link in the legend will flash matches in the overview pane to show you where to scroll to them.
• Fixed: Pop-up menus that are near the edge of the screen sometimes appeared far away from the mouse (on the Windows platform).
• New option Drawing Options | Link Labels | Display subClassOf as Superclass.

• New Graphical Query View for constructing queries as diagrams.
• The Graphical Query View has grouper boxes for group graph patterns.
• New command File | Federate Recent Stores.
• The list of recent stores now includes remote stores.
• Gruff can open remote stores on Allegrograph 4.
• A new way to select nodes and predicates from recently-used ones.
• Returning to a state in the Table View restores the scroll position.
• Menus of known catalogs and stores when doing an open on AllegroGraph 4.
• Triples can be loaded from a web page rather than from a file.
• You can create and open stores in catalogs other than root (AllegroGraph 4).
• More command line arguments for opening a store at startup. select-distinct is supported in SPARQL queries.
• New nodes are added at the mouse cursor rather than in the center.
• Feedback when a command isn't applicable to the current view.
• Multiple text lines for "Custom Properties for Node Labels".
• Improved placement of link labels.
• A bug on GTK with pop-up menus not appearing has been fixed.

• Fixed: The new File | Export commands failed when bridge lines are present.
• New option "Drawing Options | Case-Sensitive Sort for Menus".
• URIs pasted into the query string box will now use namespace abbreviations.
• Fixed: Loading gruff.fasl into lisp was broken in the previous release.
• Fixed: Much of the API for use in lisp no longer worked as documented.

• The View menu has three new commands for using an overview/scroller pane.
• New submenu File | Export Displayed Data As ...
• Child menu names are now included in the documentation.
• New freetext command "Add | Edit the Set of Registered Predicates".
• The dialog for selecting a triple-store directory has been improved.
• A thick border is drawn in the table view between the as-subject and as-object groups.

• Based on Allegro CL 8.2 and AG 3.3.
• Now available on Mac OS X 10.5 or later, which requires install gtk2 and X11.

• Fixed: Link | Add a Linked Node from Menus broke with more than 25 choices.
• Fixed: The Help | Quick Start window was blank on 64-bit Windows.
• There is a new File | Close Triple-Store command.
• File | Load N-Triples prompts for a graph to place the triples into.
• Control-shift-click no longer attempts to visit a web page for a literal.
• Prolog queries now work when some returned values are not UPIs or strings.
• Fixed a break with loading a layout that contains bridge lines.
• Fixed a problem that could make File | Load RDF / XML fail.
• Starting gruff with "gruff some-path" will open the store at that path.

• New commands on the Add menu for displaying nodes that match freetext queries.
• New dialogs allow selecting a subset of matches that exceed various user limits.
• New option Drawing Options | Show Full URIs on Nodes.
• New option Drawing Options | Specify Line Width for Selected Link's Predicate.
• New option Drawing Options | Maximum Node Label Length.
• New option Drawing Options | Enforce Maximum Node Label Length.
• New option Inclusion Options | Maximum Choices When Selecting a Subset.
• New button in the Query View to save the results as Comma-Separated Values.
• Add a Node by URI no longer requires a ! with a namespace abbreviation.
• Fixed status bar messages for busy states not appearing on Linux.
• Fixed a bad inefficiency with finding all classes in a large class hierarchy.
• Fixed a break when using Gruff on a Windows 2000 with no gdiplus.dll.
• Fixed tooltips bringing Gruff to the front when moving the mouse over Gruff.

• Options for smoother lines and text at Drawing Options | Antialiasing.
• Options for 3D node box color gradients at Drawing Options | Color Gradients.
• Options for a background pixmap at Drawing Options | Window Background.
• Option for legend background color at Drawing Options | Window Background.
• Option for a border color at Drawing Options | Node Border Color.
• If the new options above slow things down, they can easily be turned off.
• Distinct Add menu commands for adding nodes for types or their instances.
• Add an Instance Node by Class Hierarchy grays out instanceless classes.
• New option Table View Options | Show Full URIs in Tables (with shortcut).
• A query no longer reports (possibly unintended) explicit URIs not found in the store.
• The Graph View's initial canvas size no longer includes a scrolled-off area.
• The position, size, and maximized status of Gruff are remembered across sessions.
• Column widths and split-bar positions are remembered across sessions.
• The default multipredicate line style no longer uses nonantialiasable dashing.
• No-longer-existing files are removed from the lists of recent states to revisit.
• You can now cancel a layout during the final compression and centering stages.
• Fixed: Text in the legend pane sometimes failed to draw on Linux.
• Fixed: Multiple objects with the same local name were excluded from various menus.
• Fixed: Add | Add a Node By Label didn't work for no-language label literals.
• Programmatic option name abbreviate-node-labels is now exclude-namespaces-from-labels.

• There's a new Help | Use Web Browser for Menu Help option.
• Turn on use-line-color-for-link-labels by default.
• Generalize node-info and predicate-info objects so that they do not necessarily represent a UPI, and instead can represent an arbitrary string (such as one generated by a Prolog query) or a symbol (such as a variable in the upcoming graphical query view).
• Handle nodes better that represent strings that were generated by Prolog queries that are not literals in the store. Stop interning them into the store.
• Stop assuming that any literal string in a Prolog query names a UPI that's in the store. Stop searching (lisp ...) subexpressions for explicit UPIs to add to the lists of explicit UPIs from the query.
• Disable various commands on query results table cells that contain constructed strings from Prolog queries, when the commands need a UPI.
• Make the legend pane handle HOME, END, and PAGEUP/DOWN.

• Prolog queries are now supported, including defining rules and other evaluations.
• Queries can be named and revisited later in the same session from a menu.
• The File menu's save and load commands save different things in different views.
• The states to reload at the bottom of the View menu differ in different views.
• The above changes save query strings in the Query View, and objects in the Table View.
• Labels can be shown on link lines. See Drawing Options | Link Labels.
• You can press F1 while highlighting a menu command to visit its help directly.
• Finding all types and all nodes (for Add menu commands) is more efficient.
• Inclusion Options | All Types Timeout has been removed; you can abort it instead.
• Fixed: Create a Visual Graph from Results broke if no store is open.
• Fixed: Create a Visual Graph did nothing if there had been no Graph View content.
• Fixed: Clicking a query results table cell that has no value broke.
• Fixed: Display Paths Between Two Nodes sometimes scrolled the paths out of view.
• Fixed: The usual automatic layout didn't happen when adding only orphan nodes.

• Fixed: It was impossible to type certain letters into a query string on Linux.
• Fixed: Adding a single node removed the types for other nodes from the legend.
• Fixed: Adding a single node didn't push an undo state to return to.
• New command File | Apply RDFS++ Reasoner adds reasoning to the store being browsed.
• Add a Node By Class Hierarchy now lets you alternately select an instance of a class.
• New command Add a Node By Type lists all types alphabetically in a series of menus.
• Inclusion Options | All Types Timeout limits the time for searching for all types.
• The Layout Options | Displaying Paths submenu covers where to place path end nodes.
• Display Paths Between Two Nodes now pins the end nodes at the window edges by default.
• New option Inclusion Options | Finding Paths | Find Only Shortest Paths.
• Newly-added nodes and selected search matches will now flash momentarily by default.
• The new Drawing Options | Widget Font option affects the font in miscelleanous places.
• Control-right-clicking a table cell is now a shortcut for the Copy command.
• A singly-added node will move to an empty spot rather than forcing its way to the middle.
• Creating a a visual graph from query results now warns when there are many links.
• Gruff no longer closes *db* at Gruff exit time when used in a development lisp.
• The Home and End keys now work in the graph view, including horizontally with Control.
• User function find-and-display-paths now takes a finder-function argument.
• find-and-display-paths now returns the list of paths, not its length.

• Blank nodes can now be saved in layouts.
• Gruff no longer globally enables the bang reader.
• Opening a store will now always ask for read-only or read/write mode.
• The user function display-paths is now called find-and-display-paths.
• The new user function display-paths displays already-found paths.
• A warning will be shown on Linux for a null DISPLAY environment variable.
• Dragging the query results grid columns to a new order is fixed.
• Refresh the legend pane when node labels options are changed.
• GTK warnings about unregistering nonregistered menu shortcuts is fixed.
• A new command on the legend menu removes all matching nodes or links.
• The Query View now supports DESCRIBE queries.
• Error is friendler when trying a query other than a SELECT or DESCRIBE.
• You will be warned once if the open triple-store is not fully indexed.
• There's a new option "Layout Options | Limit Outward Stretching".
• A glitch with finding paths between selected nodees is avoided for now.
• A query no longer breaks if some resulting variable values are nil.
• Going back to a table that has no rows no longer breaks.
• Aborting a search in the node pane once again undoes any scrolling.

• Unconnected groups of nodes are no longer left far apart from each other.
• The new commands "Save Layout State" and "Load Layout State" on the File menu allow saving a layout and then reloading it at any time in the future when the same triple-store is open. The most recently saved or loaded layouts for the currently-open store are listed at the bottom of the View menu for quick reloading.
• There is a new optional legend pane in the graph view that displays the meaning of each predicate line style and each node type background color. Right-click an item in the legend to get a menu of a few commands that can be applied to them.
• You can now exit eraser mode by clicking the background or moving to another view or another application.
• Some menu commands that apply only to the graph view first select the graph view if it's not the current view.
• The keyboard shortcut for Load N-Triples has changed from control-L to control-shift-L to free up Control-L for the new Load Layout State command.
• New options on the View menu allow flashing nodes or links that match the selected item in the legend.
• The new command Link | Find Paths Between Two Nodes allows adding nodes and links that comprise paths between two selected nodes. There is a corresponding user function display-paths.
• Many small fixes and improvements.
• The new command Link | Display Paths Between Two Nodes is similar to the recent Link | Add Paths Between Two Nodes, but it removes all nodes and links that aren't in the paths.

• Better handling of loading triples into a pre-existing triple store.
• Fix control-shift-click gesture to send a URL to a web browser.
• Make string search in the graph view highlight multiple matches.
• Selecting a table cell with alt-click will no longer show a mouse cursor for a drag-and-drop.
• The new variables *selected-node* and *selected-link* may now be used in a development lisp where gruff.fasl is loaded.
• Improvements to the documentation, including a section for special mouse clicks.
• Better layout when a node has more than several links that have layout direction constraints.
• New option: Layout Options | Spacing Increment for Many Links. Layout | Max Links per Node Copy has moved down the menu to be with it.
• Fixed a problem with that gesture sometimes not bringing Firefox to the front.

• The distribution now includes the file gruff.fasl for using in a development Lisp.
• Fixed a problem with Drawing Options | Custom Property for Node Labels.
• Reduced the number of communications with a remote server to improve speed in client-server mode.