4.1  Glossary

Our glossary includes quite a few standard Macintosh terms, which we were unable to find good definitions for elsewhere.

❖ Active Application

Mac OS X allows you to have many applications (apps) running simultaneously, but only one is the active application at any time.  The active application is the one whose name appears next to the Apple  menu in the upper left corner of your screen.

You can quickly switch to a new active application by holding down the ⌘ key while hitting your tab key.

❖ Application Menu

The Application Menu of a Mac app refers to the first main menu item, after the Apple  menu, at the top left of your menu bar, whose title is the name of the application, in our case Smarky, Synkmark, Markster or BookMacster.

❖ Auto Save and Versions

Auto Save and Versions is a feature of Mac OS X.  It works a little differently depending on whether you have OS X 10.7 or OS X 10.9.  OS X 10.8 takes some details from both of those documents.

❖ Tab-Return Format

When dragging bookmarks to or from other applications that accept text, Smarky, Synkmark, Markster and BookMacster uses the following format:

    name-of-first-bookmark{TAB}url-of-first-bookmark{RETURN}
    name-of-second-bookmark{TAB}url-of-second-bookmark{RETURN}
    ...
    name-of-last-bookmark{TAB}url-of-last-bookmark{RETURN}

where {TAB} denotes the ASCII 0x09 character which is produced by the tab key on your keyboard in most applications, and {RETURN} denotes any of the newline characters 0x0a, 0x0d or 0x85, one or more of which is produced by the return key on your keyboard in most applications.  This behavior is configurable in most text editors.

If there is no tab character in a string that is dropped onto the Content View, the app assumes that the entire string is the URL of a desired new bookmark, and creates one with the name “untitled”.

❖ Browser Apps, Local and Web

A locally-installed browser app, commonly referred to as a web browser, is an app installed on your Mac.  The term “desktop app” has been used for this, but “desktop” is now a misnomer since more Macs are actually “laptop”.  Examples are: Safari, Firefox, Chrome, Opera.

A web-based browser app keeps your bookmarks data on a remote server.  These apps run inside your web browser.  (Note that you never “installed” these applications onto your Mac.)  Examples are: Delicious, Pinboard, Diigo.

❖ Browser Profile

Some users may prefer to compartmentalize their web browsing, so that they have different sets of bookmarks, history, and other browser app settings for different purposes.  For web-based browser apps, this is done easily by creating multiple user accounts.  This feature is also available some locally-installed browser apps, in particular  Firefox and browsers in the Google Chrome family.  Of course, in any web browser you get different bookmarks, history, and other browser app settings in each Macintosh user account.

❖ Churn

When exporting to web browsers, the app must respect each browser’s rules regarding what types of items (bookmarks, folders, separators) can be put where, and then when importing, not recognize that any moves made due to these rules should not be re-imported into the Bookmarkshelf document.  If this is not done carefully, items can be moved back and forth between two different locations during successive syncs (export + import cycles).  We refer to this as churn.

❖ Contextual Menu

Rather than searching through the Main Menu bar to find one of the commands applicable to a particular item, some application views provide menus that pop up on the item and show only these applicable commands.  To access a contextual menu for an item, click it with a secondary click.

❖ Devices

It is fashionable nowadays to use the term devices to refer to, collectively,

❖ Dock Menu

Application items in your Mac OS X Dock show a menu when you click them with a secondary click.   Secondary-click the app’s icon to see its Dock Menu.  Note that an application must be running in order to show the usual items in its Dock Menu.

❖ Enabled vs. Disabled Controls

A control which has a “grayed-out” contrast does nothing when you click on it, because it is disabled.  This is in contrast to a control in its normal enabled state.

This happens to regular controls such as checkboxes…

as well as menu items…

Note that the enabled state is independent of whether the control is ON or OFF.  In the first screenshot there, the Bookmarks Menu checkbox is disabled, although the checkmark indicates that its value is ON.

❖ External Identifier

Most web browsers attach an identifier attribute to each bookmark or folder in their content.  In Web-based browser apps, which do not allow folders nor duplicate bookmarks, this is often a hash of the bookmark’s URL.  In any case, the app uses this identifier, whenever possible, to identify this item when syncing as one that has already been synced.  If you need to see the external identifiers which the app has stored for an item, show the item in the Inspector Panel, hold down the option key on your keyboard, and click on the Export Exclusions button at the bottom.  The items external (and internal) identifiers will be logged in an entry to your system Console.

❖ Hidden Preference

In addition to the options available when you click Preferences in an application’s application menu, some applications have other preferences available to advanced users.  Preferences are hidden because either because we didn’t think it was important and thought that our time would be better spent on other stuff, and/or that we thought exposing the option to all users would make the app more confusing to the average user and have a net negative value.  To request a hidden preference, contact our Support team.

❖ Internal Bookmarks

The internal bookmarks of a web browser such as Safari refers to those bookmarks which you see when you click its Bookmarks menu item.  Internal bookmarks may also appear in the toolbar at the top of a browser window in these applications.  This so-called Bookmarks Bar or Bookmarks Toolbar is part of a browser’s internal bookmarks.  Bookmarks in the Bookmarks menu itself may comprise all or part of the internal bookmarks, depending on the browser’s design.

We use this term to distinguish these browsers’ bookmarks from the bookmarks stored in a  Bookmarkshelf document.

❖ Lineage and Hierarchy

The lineage of a bookmarks content item is its “location” or “place” in a hierarchy, defined by the following sequence:

Several things to note here…

An efficient way to view the hierarchy of items, is using an outline view or as we call it, Outline Mode.  The app uses the icon to indicate lineage, and to indicate Outline Mode.

If the lineage of bookmarks content items is ignored, viewing them results in a “flat” view, simply a list, or as we call it, Table Mode.  The app uses the icon to indicate  Table Mode.

❖ Macintosh User Account

The Macintosh supports multiple users, keeping all of your documents, settings and personal data, including bookmarks, separated into different Macintosh User Accounts.  The data in each account is stored in a different Home Folder.  If you are the only user of your Mac, you probably have only one Macintosh User Account on it, but computers shared among families or company employees are often configured with one account for each user.  When each person logs into their Macintosh User Account, they see only their own documents, data, settings and bookmarks, from their own Home folder.

A Macintosh User Account can only be on Macintosh computer at one time.  If you regularly use two Macintosh computers, even if they have the same account name in the upper-right corner of the menu bar, you are actually using two different Macintosh accounts unless you carry the Home folder around on a portable hard drive or thumb drive and plug it in to whatever Mac you are using.  The account is still only one one Macintosh at a time, but it is portable.

❖ Mac OS X Keychain

Although used under the hood by Safari and many applications to securely store passwords, the Keychain is an not-well-understood feature of Mac OS X.  Even Apple itself does not tell us very much about it.  We did find a good MacWorld article written back in 2004 by Dan Frakes.

❖ Nontrivial Attributes

A nontrivial attribute is any attribute of a bookmarks content item which is not one of the following trivial attributes.

Note that an item’s index, that is, its position among its siblings, is not a trivial attribute.  (If it were, then we would not export the changes when bookmarks are only sorted.)

❖ Online File Syncing Service, Online Synced Folder

An Online File Syncing Service is a service that keeps items in a designated folder or folders on your different Macs synchronized, which means that any files in this folder that you change on one Mac are, typically some minutes later, or as soon as they wake up, copied to your other Macs.  We refer to such a folder as an Online Synced Folder.  An Online File Syncing Service  also provides a backup for this data, because it is also stored on their servers.  We maintain a web page showing our current evaluations of various such services

Putting your Bookmarkshelf document in such a designated folder is one way to get the same bookmarks on multiple Macs.

We maintain a web page with our current evaluations of various Online File Syncing Services useable with Synkmark or BookMacster.

❖ Orphaned Items

An orphaned item is a bookmark, folder, etc. which has no parent and therefore no place in a the hierarchy of a the bookmarks content of a Bookmarkshelf().  It cannot be displayed, and may cause confusion if it matches to incoming items during an Import operation.

❖ Rating (stars)

In the Inspector panel, you can assign a bookmark or folder to have 1-5 stars.  Generally, this is to indicate how useful the bookmark is, but you can use it however you want.  By default, items have 0 stars which means that they are unrated.

❖ Readable Web Browser Application

A Readable Web Browser Application is a web browser from which Markster or BookMacster can extract the current web page to create a bookmark.  The Readable Web Browser Applications are: Safari, Firefox, Google Chrome, Chromium, Canary, and OmniWeb.

❖ Secondary Click

Performing a secondary click on an item brings up its contextual menu.  There are several ways to do it.

So that we don’t have to keep referring to secondary click or right-click or control-click, we refer to any of the above using what appears to be Apple’s latest term, secondary click.

❖ Source and Destination

In an Import operation, the Import Client(s) are source(s) and the Bookmarkshelf() is the destination.  In an Export operation, the Bookmarkshelf() is the source and the Export Clients are destination(s).

❖ Status Bar

The Status Bar is the line of text and sometimes other controls which is along the bottom of the app’s document window.

After an Import or Export operation, the numbers +, Δ, and - respectively indicate the number of

❖ Status Menulet

Status Menulet refers to one of the icons you see lined up at the top of your screen, starting at the right side.

Apple uses the variously the terms Status Menu or Menu Extra, or in their technical documentation the term Status Item, and many Mac users have adopted the more descriptive term Menulet.  So, it’s not your fault that you’re so confused!

Status Menulets are handy, but the problem is that space is limited and Apple gives them secondary priority to the Main Menu Bar of the active application, which is displayed starting on the left side.  If the active application’s Main Menu has too many items with long names, its Main Menu Bar will collide with the Status Menulets in the middle, and the Main Menu Bar wins.  Status Menulets which do not fit are wiped out.  Therefore, particularly on a laptop or other small-screen Mac, you need to economize and only activate the menulets which are most useful to you.

Status Menulets are only shown when their application is running, and when running, most apps allow you to turn their Status Menulet ON or OFF in their Preferences Window.  The control for the app’s Status Menulet is in Preferences > General.  By default, it is OFF.

Like most applications, the app duplicates the content of its Status Menulet in its Dock Menu.  So, if you don’t have room for it in your menu bar, you can access the same functions in BookMacter’s Dock Menu.

Syncing Agent

A Syncing Agent is an Agent which can Import or Export.  That is, at least one of its Commands is an Import or Export command.

❖ Tag Delimiter

For historical reasons, in browser apps which support tags, you enter the tags into one long text field, and therefore there must be a character which you type to signal the end of one tag and the beginning of another tag.  We call this character the tag delimiter.

For Pinboard and iCab, the tag delimiter is the space character, ” “.  This means that if you want a tag which is more than one word, you must connect the words by something other than a space.  For example, computer software is no good but computer-software will work.

For Delicious, Firefox, the tag delimiter is a comma, “,”.  For Smarky, Synkmark, Markster, or BookMacster, you can set the tag delimiter to one of several choices in Preferences > General, and you may override this choice for any Bookmarkshelf Document in the tool Settings, tab General.  In a Bookmarkshelf Document which syncs with only one tab-supporting Client, you may want to set the tag delimiter to the same tag delimiter which is used by that Client.

For Diigo, the tag delimiter character is, effectively, the doublequote character, “”“.  But they do it a little differently; tags are doublequoted.  Diigo does other weird character replacements too.

❖ Tag Delimiter Replacement

A problem arises when syncing between Clients that use different tag delimiters – tags may be merged together or split apart.  Smarky, Synkmark, Markster, and BookMacster solve this problem by replacing delimiter characters found within tags by your preferred Tag Delimiter Replacement.  You specify this in Preferences > General.  By default, it is the underscore character.  For example, when you support the tag computer software to Delicious, it will be exported as computer_software.

❖ Tags

Tags are phrases that you may attach to bookmarks to aid in searching later, as explained in this Wikipedia article.

❖ Trace

As a verb, to log the processing actions verbosely, that is, with more entries than the normal Log you see when you click in the menu application menu > Logs… > Messages.  As a noun, the text file which is written to your Desktop containing the trace entries.  This can be useful in troubleshooting problems.  To produce a trace file during an Import or Export operation, hold down the shift and option keys on your keyboard while the operation is beginning.  Keep them held down until you hear the Submarine alert sound.

❖ Traffic-Shaping Policies

Traffic Shaping is the set of programmed rules or algorithms by which servers on the internet which serve content, or routers within the internet, may choose to delay, sometimes infinitely, transmission of packets or entire requests for data.  For reasons which the reader can surmise, there seems to be not much information available publicly on this topic.  Again, the best starting point may be a Wikipedia article.

❖ Tooltip

Mac OS X provides tooltips, helpful explanations that appear in small borderless windows when you hover your mouse over items that the app designer felt needed more explanation for new users, without cluttering the view for experienced users.

(Prior to OS X 10.10 Yosemite, the rectangle was yellow instead of gray.)

The idea is that new users will set their mouse over a confusing item, then stop and scratch their heads for a few seconds.

How Mac OS X decides when you’re doing this is a little more complicated and rather inscrutable, and this is sometimes frustrating.  If you really want a tooltip for an item, first make sure that the item’s window is active.  Then put your mouse over it and let go.  Wait 5 seconds.  If nothing appears, move your mouse away, bring it back, let go and wait another 5 seconds.  If nothing appears after the second try, the item probably does not have a tooltip.

If your subject is a control in a table, hover over the column heading which names the control, rather than the row in the table.

❖ Unsaved Changes Dot

The left side of the title bar in a Macintosh document window has three buttons: red, yellow and green.  The red one closes the window when clicked, but also indicates if the document has unsaved changes, with a black dot at its center.  If you attempt to close a window when the black dot is present, you will be asked whether or not to save the unsaved changes.

❖ Untyped Item

An orphaned item is an item in the bookmarks content of a Bookmarkshelf() which does not have enough attributes to be properly displayed, because we don’t even know if it is a bookmark or a folder.

❖ XBEL File Format

The XML Bookmark Exchange Language (XBEL) file format is a mechanism by which Smarky, Synkmark, Markster or BookMacster can import and export its content with other bookmarks management applications which also support XBEL.  XBEL supports folders and hierarchy.  It also supports the following item attributes: name, URL, comments, date added, last modified date and last visited date.  In addition to these officially supported attributes, the app is able to import tags and comments which are kindly exported by Webnote™.