Issue 24386 - DOC: document Rich Text Control
Summary: DOC: document Rich Text Control
Status: CLOSED FIXED
Alias: None
Product: Base
Classification: Application
Component: code (show other issues)
Version: OOo 1.1
Hardware: All All
: P4 Trivial (vote)
Target Milestone: OOo 2.0
Assignee: marc.neumann
QA Contact: issues@dba
URL:
Keywords:
Depends on:
Blocks: 24385
  Show dependency tree
 
Reported: 2004-01-14 11:24 UTC by Frank Schönheit
Modified: 2006-05-31 14:29 UTC (History)
3 users (show)

See Also:
Issue Type: ENHANCEMENT
Latest Confirmation in: ---
Developer Difficulty: ---


Attachments

Note You need to log in before you can comment on or make changes to this issue.
Description Frank Schönheit 2004-01-14 11:24:52 UTC
*** autogenerated child task for Issue 24385 ***
Comment 1 Uwe Fischer 2004-01-14 11:54:49 UTC
is there a spec doc soemwhere?
Comment 2 Frank Schönheit 2004-01-14 13:04:40 UTC
not yet - this is what issue 24388 is about
Sorry, but since we're required to add tasks to CWS before actualy starting with
the task, I needed to submit these issues without a preliminary spec.
Comment 3 hans_werner67 2004-02-02 12:32:11 UTC
change subcomponent to 'none'
Comment 4 Uwe Fischer 2004-07-15 10:20:41 UTC
edited text\shared\02\01170101.xml
Comment 5 Uwe Fischer 2004-10-18 13:12:52 UTC
.
Comment 6 Uwe Fischer 2004-10-18 13:13:37 UTC
UFI: pls verify in CWS helpcontentbeta and close
Comment 7 thorsten.ziehm 2004-11-15 12:09:34 UTC
Set to correct status 'resolved fixed'.
Comment 8 marc.neumann 2004-11-17 12:10:23 UTC
not fixed in cws helpcontentbeta
I can't found anything in the help about Rich Text Controls.
Comment 9 marc.neumann 2004-11-17 12:10:49 UTC
reassign to ufi
Comment 10 Uwe Fischer 2004-11-17 12:20:07 UTC
Please enter "rich" in the Index Search term box. You should see the Controls
help page with "Text type" at the top. This is the help text:

"Allows you to use line breaks and formatting in a control field, such as a text
box or label. To manually enter a line break, press the Enter key. Select
"Multi-line with formatting" to enter formatted text."
Comment 11 Uwe Fischer 2004-11-17 12:21:01 UTC
aargh - this weird Issuzilla task handling!
Comment 12 Uwe Fischer 2004-11-17 12:21:50 UTC
please look once more
Comment 13 Uwe Fischer 2004-11-17 12:22:06 UTC
.
Comment 14 marc.neumann 2004-11-17 13:44:57 UTC
Oh, you mean this single sentence 

"Select "Multi-line with formatting" to enter formatted text"

describe the whole new MS interoperability Feature "Rich Text Control".

You are joking, don't you?

Please see the spec
http://dba.openoffice.org/specifications/forms/rich_text_control.sxw for details
what is possible with rich text controls and what not.
Comment 15 marc.neumann 2004-11-17 13:45:30 UTC
reassign to ufi
Comment 16 Uwe Fischer 2004-11-17 14:21:35 UTC
Yes, I know the spec doc. And no, I will not quote all the attributes that a
rich text control can have: 
start_of_quote:
Font, Font style (bold/italic), Font size, Font Language, Underlining,
Strikethrough, Text line color, Font color, Word line mode, Relief, Outline,
Shadow, Position (Superscript/Subscript), Scaling, Kerning.
Additionally, the following character attributes are available when Asian
Language support is enabled in the OpenOffice.org installation: Emphasis mark,
Emphasis mark position.
Yet more additionally, the attributes Font, Font style, Font size and Font
Language are available in an Asian and/or complex text version, if and only if
"Asian language support" respectively "Complex text layout support" is enabled
in the OpenOffice.org installation.
The semantics of these attributes follows their semantics in other contexts, for
instance when used for the text in a shape. The reader is referred to the
"Character" dialog for such text, in particular the well-known tab pages "Font",
"Font effects", and "Position". Every attribute on these tab pages will be
supported by the rich text control, and every attribute supported by the rich
text control will be available on these tab pages.
end_of_quote.
This is of no help to the normal user. For the normal user, the information that
it is possible to apply formatting to the contents of a text box is sufficient.
The user can then select all the formatting he wants; it is visible in the UI
what is available. There is no need to provide detailed lists. We even have no
lists which attributes can be applied to normal text. So why for text on a
control which is used at most by one out of a million users?
Comment 17 marc.neumann 2004-11-17 14:49:45 UTC
Hi,

you don't need to explain all the formats you can apply to text, of cource,
however may be you can provide a little bit more information about this new
feature. For example you can not bind this kind of controls to a database field. 

Why shouldn't we say what we can?
For me this feature is till not enough documented,
But may be any other has an other opinion.  MSC -> FS , FPE , TZ: Any opinion?

Bye Marc
Comment 18 frank.thomas.peters 2004-11-17 14:55:47 UTC
FPE:
> Why shouldn't we say what we can?
Because Online help is not a marketing instrument. We describe what is needed
for the user to operate the software. I took a look and IMO the documentation is
basic but ok. If you think that more is needed we should open an RFE for OOo later.

> For me this feature is till not enough documented,
We don't document features as such. If I understood correctly, the feature
manifests in one single drop down list entry. We document it using one single
clearly understandable sentence. For me that's fine.
Comment 19 Frank Schönheit 2004-11-17 15:53:27 UTC
I kind of agree to both sides. On the one hand, we don't really want to list
every single attribute, for most users it's sufficient to know that they can
somehow "format" the text in the control.

On the other hand, IMO it would be nice to also document the restrictions which
this mode has, in particular, as msc said, that formatted text cannot be stored
in a database field, and thus the respective controls in the property browser
are disabled then.

There are other implications of chosing "text with formattin", but of much less
interest (like scrollbars, line ends, and such).

So, could we agree on adding the DB restriction to the text as some "Note: ...!"?
Comment 20 Uwe Fischer 2004-11-17 16:17:12 UTC
After choosing the "Text type" "Multi-line with formatting", the Data tab page
on the control's properties window disappears. This will be documented.
(Although it looks like a bug). This should fix the reference help for this control.
On the other hand, we do not have a how-to guide on using controls at all. But
we need several guides for those features. And when xforms will appear one day,
it is much more important. This is another topic not to be covered by this bug.
Comment 21 h.ilter 2004-11-22 15:55:17 UTC
.
Comment 22 Uwe Fischer 2004-11-23 08:21:47 UTC
.
Comment 23 frank.thomas.peters 2004-11-23 15:06:26 UTC
FPE: reset target
Comment 24 Uwe Fischer 2004-12-15 13:28:21 UTC
added a warning to text\shared\02\01170101.xhp
Comment 25 frank.thomas.peters 2005-01-25 11:12:46 UTC
.
Comment 26 frank.thomas.peters 2005-01-25 12:05:22 UTC
FPE: Pls verify in hc680postbeta
Hint for QA: index entry "rich text control"
Comment 27 frank.thomas.peters 2005-01-25 16:51:29 UTC
fixed
Comment 28 frank.thomas.peters 2005-01-26 08:14:04 UTC
FPE: Due to time constraints removed from CWS
Comment 29 frank.thomas.peters 2005-01-26 08:14:17 UTC
FPE: Due to time constraints removed from CWS
Comment 30 marc.neumann 2005-06-09 13:25:43 UTC
verified in current master m106 -> close this issue now.