-This specification is outdated, please use the following new specification -

State name of Office module in Window Title

OpenOffice.org 2.0

Document - ID	Specification Owner	Last Change	Status
	Falko Tesch	08/04/06	Final
Conforms to	PCD Requirement
Applies to	OpenOffice.org, all modules
Task ID(s)	20125
Category	Feature Request

Abstract

Instead of showing the filename or the title (if available) and the Office name within the window title now the file name of the document plus the office suite components name will at display.

i-Team Members (The specification Owner is part of the i-Team)

	Name	E-mail Address
User Experience	Falko Tesch	falko@sun.com
Development	Oliver Specht	Oliver.specht@sun.com
Quality Assurance	Thorsten Martens	Thorsten.martens.@sun.com
Documentation	Uwe Fischer	Uwe.fischer@sun.com

Approved for Implementation

	Approved by	Date
User Experience	Falko Tesch	16.12.2003
Development	Oliver Specht	28.11.2003
Quality Assurance	Thorsten Martens	10.12.2003
Documentation	Uwe Fischer	28.11.2003
String Review	Elizabeth Matthis	11.02.2004

Document Change History

Rev. Level	Change	Initials	Date
1.0	Falko Tesch	FT	20.11.2003
1.1	Falko Tesch	FT	27.11.2003
1.2	Falko Tesch	FT	16.12.2003
1.3	Falko Tesch, added module sglobal	FT	03.02.2004
1.4	Falko Tesch, added Liz approval -> Final	Ftq	08.03.2004
1.5	Falko Tesch, added Future Task issue	FT	30.03.2004
1.6	Falko Tesch, added missing/new modules	FT	01.07.2004
1.6a	Falko Tesch, added hints for translation in string list	FT	02.09.2004

Contents

Glossary	1

1	Motivation	1

2	User Scenario	1

3	Goals	1

4	Requirements and Dependencies	2

4.1	Requirements	2

4.2	Technical Dependencies	2

5	Competitive Analyses	2

6	Detailed Specification	2

6.1	Error Conditions	4

7	Future Tasks	4

8	Notes	4

9	References	4

Glossary

Term	Description
%PRODUCTNAME	A placeholder for the current name of the office suite, like “OpenOffice.org”
%PRODUCTVERSION	A placeholder for the version of the office suite, like “2.0”
%FILENAME	A placeholder for the filename of the current open file in the module, loke “foobar.sxw”
MDI	Multi Document Interface, multiple document are opened in one application window
SDI	Single Document Interface, every document opens in its own window
Window Title	The text/content that is displayed as information about the program within the operating system windows'
Module	Name of one of the OpenOffice.org applications, like “Writer”

Motivation

For the moment all open documents place their title name within the window title bar followed by the %PRODUCTNAME %PRODUCTVERSION string. This leads to confusion since the window title bar does not state what kind of document is currently open, e.g. a Writer document and a Calc spreadsheet. This situation gets even more unclear once the user looks for those document windows in the task bar. Here only the file name and a little icon (if the window manager supports this) are available for distinction. To avoid such unclarity it is advisable to add the office suites module name into the window title bar. Furthermore it might be advisable to drop the %PRODUCTVERSION string instead (to keep the window title bars string length at hand).

User Scenario

A user works with Writer, Calc and Impress the same time. He opens and creates three documents, one Writer, one Impress and one Calc.

Since his project he is working on is named “Fiscal Year 2004” he chooses this as the title for all three of them. What happens now is that all three application windows display the following string in their window title bar:

[ICON] Fiscal Year 2004 - OpenOffice.org 1.1

The only way for the user to distinguish in between his three documents is the icon [ICON]. But in case of an Window Manager that does not support icons even that little hint for distinction is gone.

Note: This window title string is used everywhere within the OS (taskbar, task pane, window title bar etc.)

Goals

Define a new window title label for all office modules to make it easier to distinct in between applications and/or file names.

Requirements and Dependencies

Requirements

none

Technical Dependencies

none

Competitive Analyses

Under Windows 2000/XP, KDE 3.1* and Gnome 2.2* a window title always consists about an application icon and a title. (* this goes only for the standard themes on these window managers!)

Most applications like MS Office, KOffice, Lotus Smartsuite or Corel Office have their application name and the file name of the current open document displayed in their window titles.

Since they all have the same information within their window title they do not have always the same sequence. Some, like MS Word or KWord first list the file name and then the application name others like MS Excel do it vice versa.

In all cases this depends if the application uses an MDI or SDI.

MDI applications have their application name first and the current active file name second.

SDI applications have the file name first and the application name second.

Detailed Specification

OpenOffice.org 2 will change its window title according to what (most) other SDI applications conform to:

[ICON] File Name - %PRODUCTNAME Application Name

File Name:

The physical name of a file without its extension (.s[x|t][cdimw], .html, .doc, etc.)

Application Name:

Name of the office suite module. Writer, Writer/Web, Calc, Impress, Draw or Math

Example: A document with the title (“File - Properties - Tab Page: Description - Title”) “Fiscal Year 2004” and the file name “FY_04.sxw” produces currently a window title reading: Fiscal Year 2004 - OpenOffice.org 1.1. This will change to: FY_04 - OpenOffice.org Writer

Reasons:

The window title must carry the application name in its window title to give the user a hint what application is running.

There is no need to display a version number in a window title. If a document, no matter what version it was created with, can be opened by an application the version number becomes obsolete and might rather add to confusion.

Even if a document has a title (most don't) in some cases the title differs from the real file name. Also many users saving their document under another file name are confused to find the window title bar not changing the document title.
Since all OS nowadays support long filenames (incl. spaces) most users will anyway use expressive filenames instead (and use them also for titles if at all) and will tend to remember (and search) for the filename.

String list

Note: Every space within the strings below must be treated as a space! And every string is to be treated as one line.

Item	English	German	Comments
Window Title	%FILENAME - %PRODUCTNAME Writer	%FILENAME - %PRODUCTNAME Writer	Application name for text processor [swriter] – String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Writer	%FILENAME - %PRODUCTNAME Writer	Application name for global text doc processor [sglobal] – String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Writer/Web	%FILENAME - %PRODUCTNAME Writer/Web	Application name for text processor in HTML mode [sweb]– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Calc	%FILENAME - %PRODUCTNAME Calc	Application name for spreadsheet [scalc]– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Impress	%FILENAME - %PRODUCTNAME Impress	Application name for presentation [simpress]– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Draw	%FILENAME - %PRODUCTNAME Draw	Application name for drawing module [sdraw]– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Math	%FILENAME - %PRODUCTNAME Math	Application name for formula editor [smath]– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Basic	%FILENAME - %PRODUCTNAME Basic	Application name for Basic IDE (where %FILENAME refers to the loaded macro script)– String must not be translated!
Window Title	%FILENAME - %PRODUCTNAME Base	%FILENAME - %PRODUCTNAME Base	Application name for new database application– String must not be translated!
Window Title	%PRODUCTNAME	%PRODUCTNAME	Application name for start module [soffice]
Window Title	%FILENAME - %PRODUCTNAME Chart	%FILENAME - %PRODUCTNAME Chart	Application name for chart module [n/a] Note. This module is not available in 1.1– String must not be translated!

Tab Order

none

Key Board Shortcuts

none

Error Conditions

none

Future Tasks

For accessibility reasons we must address the issue of untitled documents, since screen-readers cannot properly naturally speak out terms like “Untitled1” etc.

We must change them to machine readable terms: “Untitled 1”

This request is based on (closed) issue 14358

Notes

References

This specification is the binding master document for

http://specs.openoffice.org/appwide/start_module/StartModule.sxw

http://specs.openoffice.org/appwide/separate_modules/OptionsDialog.sxw

that will define the new/updated module titles within OpenOffice.org's components.

State name of office module in title bar

Page 5

Http://specs.openoffice.org/appwide/module_name_in_caption_bar/module_name_in_caption_bar.sxw

-This specification is outdated, please use the following
new specification -

State name of office module in title bar

Falko Tesch

2003-11-19T15:41:44

Frank Loehmann