Archive

Archive for the ‘Documentation’ Category

Session videos from JAMF Nation User Conference 2016 now available

November 4, 2016 Leave a comment

Jamf has posted the session videos for from JAMF Nation User Conference 2016, including the video for my documentation session.

For those interested, all of the the JNUC 2016 session videos are available on YouTube. For convenience, I’ve linked my session here.

Slides from the documentation session at JAMF Nation User Conference 2016

October 20, 2016 1 comment

For those who wanted a copy of my documentation talk at at JAMF Nation User Conference 2016, here are links to the slides in PDF and Keynote format.

PDF – http://tinyurl.com/JNUC2016DocPDF

Keynote – http://tinyurl.com/JNUC2016DocKeynote

Documentation session at JAMF Nation User Conference 2016

October 11, 2016 Leave a comment

I’ll be speaking about how to various ways to document your Casper Suite and other IT needs at JAMF Nation User Conference 2016, which is being held from October 18th – 20th, 2016 in Minneapolis, MN. For those interested, my talk will be on Thursday, October 20th.

For a description of what I’ll be talking about, please see the Preparing for the Road Ahead: Documenting Your Casper Suite Setup session description. You can see the whole list of JNUC sessions here on the Sessions page.

Opening Microsoft Works files on a Mac

September 1, 2016 5 comments

A colleague recently asked for assistance with opening a particular document, which was created using Microsoft Works. Microsoft Works had a long run as a lower-cost alternative to Microsoft’s Office for Microsoft Windows and MS-DOS, and was available in one version or another for about twenty years between 1988 and 2008. As a consequence, a number of older PCs still have it installed and Mac users will occasionally receive Works documents. Unfortunately, Microsoft Works was not ported to the Mac so it can be difficult to open these files.

After talking with my colleague and researching this issue, I found two ways (one is free, the other is using a paid application) to open Microsoft Works files. For more details, see below the jump.

Read more…

Session videos now available from X World Conference 2016

July 26, 2016 1 comment

The good folks behind X World have now posted the session videos from X World 2016. All are accessible from the X World 2016 YouTube playlist page, which is available via the link below:

https://www.youtube.com/playlist?list=PLUzsToqd-eE8-yMclT6qzh2lUP-XI0uvD

As all the session videos have been posted to YouTube, I’ve linked my OS X Security: Defense in Depth session here:

The Documentation – Why All The Cool Kids Are Doing It session is linked here:

Exporting Unix man pages to plain text files

July 13, 2016 6 comments

While working with different versions of Mac OS X and macOS, it’s often been useful to me to be able to export the contents of a particular command line utility’s Unix man page to a plain text file. Man pages are the built-in documentation method available in Unix-based systems, so Apple documents how to use the various command line tools used by the operating system using this documentation method.

Exporting to a plain text file allows me to compare macOS Sierra’s man page for a particular command line utilty to a exported copy of the same utility’s man page from OS X El Capitan and see where changes to the man page have been made. This comparison is made by using diff, or other file comparison tools like Kaleidoscope, which helps me quickly spot where Apple has made changes to their documentation.

To export man pages to a plain text file, I use the col command line utility to read the contents of the man page in using stdin, then export out to a plain text file using stdout As an example, here’s how to use col to export the diskutil man page to a new plain text file named diskutil.txt:

man diskutil | col -bx > /path/to/diskutil.txt

In this case, col‘s -b and -x functions are used to make sure that the formatting for the diskutil man page remains intact when exported to the plain text file.

Slides from the Documentation session at X World 2016

July 8, 2016 Leave a comment

For those who wanted a copy of my documentation talk at at X World 2016, here are links to the slides in PDF and Keynote format.

PDF – http://tinyurl.com/XWorld2016DocPDF

Keynote – http://tinyurl.com/XWorld2016DocKeynote

%d bloggers like this: