[Libreoffice] [PATCH] Rename "Default Formatting" --> "Clear Direct Formatting"

Octavio Alvarez alvarezp at alvarezp.ods.org
Fri Jan 21 15:09:17 PST 2011


Hi.

The purpose of the following set of patches is to rename "Default
Formatting" to "Clear Default Formatting" across all the suite. The goal
is to clarify what this function currently does and should do. The current
situation is that everybody has its own interpretation of this, mainly
because "Default Style" and "Default Format" are different things and
neither of them mean "clear direct formatting". This mess doesn't help us
have a common ground for decision taking. Even the specification[1] behind
it is ambiguous.

After a bit of analysis, I found that formatting applied over styles is
uniformly called "direct" throughout the help but some code still talk
about "hard" format.

This should allow us to have a common ground for this. Should another
resetting-specific need arise, then it will clearly be an enhancement
request. Should a function do anything different than just "clear direct
formatting" it will clearly be bug.

I hope the user to benefit too, as the new name better answers the
question "what does this do": it clears direct formatting.

The patches rename all existing instances of "Default Formatting" to
"Clear Direct Formatting", including menus and help texts. Search was done
using ./g grep and replacement was made by hand. Some instances were not
changed. For example, there was uno:ResetAttrs and uno:SetDefault, which
obviously refer to different things. uno:SetDefault was left alone.

The set of patches apply to different repositories.

In the upcoming days I will include another set of patches to rename
"Clear formatting", which removes direct and sets default style, to "Clear
all formatting" (I'm not so convinced about the phrasing, but that was the
best+shortest text I could come up with). This should clarify it even
more. I request for comments.

There are still other instances of "Default Formatting" that should be
renamed to "Apply Default Style", but I can't find it as a user, so I'll
wait for this.

[1]
http://specs.openoffice.org/writer/formatting/Assigning_Styles_in_Writer.sxw
-------------- next part --------------
A non-text attachment was scrubbed...
Name: help-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 12352 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0006.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: calc-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 854 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0007.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: testing-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 5317 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0008.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: libs-core-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 1940 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0009.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: writer-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 852 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0010.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: extensions-0001-Default-Formatting-Clear-Direct-Formatting.patch
Type: application/octet-stream
Size: 1144 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/libreoffice/attachments/20110121/a5924b09/attachment-0011.obj>


More information about the LibreOffice mailing list