PATH Contents > Text Reports
Text Reports

The text report view presents the contents of reports as enriched text and offers multiple options to customize and navigate the text.

Text - Overview
Fig.1 - Text report view

The text report view is divided into 3 parts:

This chapter will explain how to use links to navigate inside a report, how to choose which sections or backtrace components should be visible and how to play with themes.

To learn how to use the jump bar, see Chapter 4, Using the jump bars.


Navigation inside the contents view

The contents of text reports is displayed in a standard text view. As expected, reports can be scrolled using the scrollers, the scroll wheel, the arrow keys, etc.

As seen in the Jump bar paragraph, you can also use the Report sections component of the jump bar to jump to a specific section of the report.


There are additional ways to jump to specific location in the report using the actions available in the menu bar:

To jump to a specific section of the report:

1Choose Navigate > Jump to Section.
2Choose the section or thread you want to jump to.

To jump to the crashed thread:

1Choose Navigate > Jump to Crashed Thread.

To jump to a specific line:

1Choose Jump to Line…
2Type the line number and validate with Return.

Finally, you can also use the hyperlinks Unexpectedly add in text reports to quickly jump to specific locations:


Text - Hyperlinks

Fig.2 - Hyperlinks

To jump to the crashed thread:

1Click the "Crashed Thread" label in the Exception Information section of the report.

To display more information about the type of exception:

1Click the underlined name of the type of exception.
2Click "Open on Apple's Developer Site" if you want to know even more about the type of exception.

To jump to the listing a of binary image:

1Click the binary name in stack frame.

Presentation options

The presentation options are available at the bottom of the contents view.


Text - Presentation Options
Fig.3 - Text presentation options

The following filtering options are available:


To hide or show some sections of a report:

1Click the Sections filter button or choose Report Viewer > Visible Sections.
2Choose the sections you want to hide or show.

To only display the backtrace of the crashed thread:

1Click the crashed thread toggle.

Unexpectedly also lets you show or hide some components of the stack frame of a backtrace:

To hide or show the binary name of stack frames:

1Click the binary name toggle.

To hide or show the machine instruction address of stack frames:

1Click the machine instruction address toggle.

To hide or show the byte offset (and source file) of stack frames:

1Click the byte offset toggle.


See the Preferences chapter to learn how to:
  • define which sections and which components should be visible by default
  • switch the line wrapping style
  • show the line numbers


Themes

Text reports are presented as enriched text using themes. This hopefully helps making the most important data stand out from the rest of the report.

By default, Unexpectedly offers you to choose among a list of 6 themes. There are light and dark versions of 3 main themes:

Default ThemeDescription
DefaultColored theme. Values are highlighted. Backtraces highlight the calls from the binary. The dark version of this theme is the default one of Unexpectedly.
MonochromeBlack text on white background or white text on black background.
PresentationThe same colored theme as the Default one but the text is bigger so that people can more easily read it when they are far from the screen or the screen of the Mac is mirrored on a bigger one.


To switch the current theme:

1Choose Report Viewer > Themes.
2Choose the themes you want to use.

To increase or decrease the font size

1Choose Report Viewer > Font Size.
2Choose Increase or Decrease.

To reset the font size

1Choose Report Viewer > Font Size.
2Choose Reset.

To edit the default themes or create new ones:

1Choose Report Viewer > Themes > Edit Themes…

To learn how to edit, create, import and export themes, see the Preferences chapter.


Export options

If you wish to use the themed reports outside of Unexpectedly, you may want to use the export options. They will produce a document in some common formats that will match as best as possible what you see in Unexpectedly.

A report can be exported in the following formats:

FormatDescription
HTMLThe report will become an HTML document. The theme will be preserved and the internal hyperlinks will be available.
PDFThe report will become a PDF document. The theme will be preserved. It will be a one page document.
RTFThe report will become a RTF document. The theme will be preserved.


To export a report:

1Select the report either using the sidebar or the jump bar.
2Choose File > Export > Report…
3Choose the Export format.
4Choose whether you want to export the entire report or just the currently selected part of the report.
5Type the name of the exported report in the Export As: text field.
6Choose the location where to export the report.
7Click Export.




Revision History
04/12/21 First version

Copyright 2021 Stéphane Sudre. All rights reserved.