summaryrefslogtreecommitdiff
path: root/Source/WebKit/qt/docs
diff options
context:
space:
mode:
authorSze Howe Koh <szehowe.koh@gmail.com>2013-04-04 16:18:30 +0000
committerThe Qt Project <gerrit-noreply@qt-project.org>2013-04-05 12:55:08 +0200
commit4378e48208f76ec39fdb32dbdbb0e03dd804bf65 (patch)
tree8d33de9b8b2cdcbf3d90b9b1aff0eaead061e5ee /Source/WebKit/qt/docs
parentcef77ac6846fa60b3baa5731164c5efca651becb (diff)
downloadqtwebkit-4378e48208f76ec39fdb32dbdbb0e03dd804bf65.tar.gz
[Qt] docs: Fix module name format
https://bugs.webkit.org/show_bug.cgi?id=113209 Reviewed by Jocelyn Turcotte. Make QDoc-generated documentation follow the conventions at http://qt-project.org/wiki/Spelling_Module_Names_in_Qt_Documentation Source/WebKit/qt: * Api/qwebdatabase.cpp: * Api/qwebkitglobal.cpp: * Api/qwebpluginfactory.cpp: * Api/qwebsettings.cpp: * WidgetApi/qgraphicswebview.cpp: * WidgetApi/qwebframe.cpp: * WidgetApi/qwebpage.cpp: * WidgetApi/qwebview.cpp: * docs/qtwebkit-bridge.qdoc: * docs/qtwebkit-goes-mobile.qdoc: * docs/qtwebkit.qdoc: Source/WebKit2: * UIProcess/API/qt/qquickwebview.cpp: Change-Id: I27927b6a3722f86379fdc538a53f4cc84c68494f git-svn-id: http://svn.webkit.org/repository/webkit/trunk@147637 268f45cc-cd09-0410-ab3c-d52691b4dbfc Reviewed-by: Simon Hausmann <simon.hausmann@digia.com>
Diffstat (limited to 'Source/WebKit/qt/docs')
-rw-r--r--Source/WebKit/qt/docs/qtwebkit-bridge.qdoc64
-rw-r--r--Source/WebKit/qt/docs/qtwebkit-goes-mobile.qdoc14
-rw-r--r--Source/WebKit/qt/docs/qtwebkit.qdoc14
3 files changed, 46 insertions, 46 deletions
diff --git a/Source/WebKit/qt/docs/qtwebkit-bridge.qdoc b/Source/WebKit/qt/docs/qtwebkit-bridge.qdoc
index 2975d157f..c7b3c27e7 100644
--- a/Source/WebKit/qt/docs/qtwebkit-bridge.qdoc
+++ b/Source/WebKit/qt/docs/qtwebkit-bridge.qdoc
@@ -1,19 +1,19 @@
/*!
\inmodule QtWebKit
\page qtwebkit-bridge.html
- \title The QtWebKit Bridge
- \contentspage QtWebKit
+ \title The Qt WebKit Bridge
+ \contentspage Qt WebKit
\section1 Overview
\section2 The technology
- The QtWebKit bridge is a mechanism that extends WebKit's JavaScript environment to access native
+ The Qt WebKit bridge is a mechanism that extends WebKit's JavaScript environment to access native
objects represented as \l{QObject}s. It takes advantage of the \l{QObject} introspection,
a part of the \l{Object Model}, which makes it easy to integrate with the dynamic JavaScript environment.
For example \l{QObject} properties map directly to JavaScript properties.
\section2 Use Cases
- There are two main use cases for the QtWebKit bridge: web content in native applications and thin clients.
+ There are two main use cases for the Qt WebKit bridge: web content in native applications and thin clients.
\section3 Web Content in Native Applications
@@ -25,7 +25,7 @@
or \l{QtDeclarative}. The music store, which shows dynamic content
from the Internet and gets modified rapidly, is best authored in HTML and maintained on the server.
- With the QtWebKit bridge, the music store component can interact with native parts of the application,
+ With the Qt WebKit bridge, the music store component can interact with native parts of the application,
for example, when a file needs to be saved to a specific location.
\section3 Thin Clients
@@ -43,22 +43,22 @@
\section2 Difference from Other Bridge Technologies
- Of course, QtWebKit is not the only bridge technology out there. NPAPI, for example,
+ Of course, Qt WebKit is not the only bridge technology out there. NPAPI, for example,
is a long-time standard for web-native bridging. Due to Qt's meta-object system, full applications
- leveraging web technologies are much easier to develop with the QtWebKit bridge than with NPAPI. NPAPI, however, is better
+ leveraging web technologies are much easier to develop with the Qt WebKit bridge than with NPAPI. NPAPI, however, is better
for cross-browser plugins, due to it being an accepted standard.
When developing a plugin for a browser, NPAPI is recommended. When developing a full application
- utilizing HTML-rendering, the QtWebKit bridge is recommended.
+ utilizing HTML-rendering, the Qt WebKit bridge is recommended.
- \section2 Relationship with QtScript
+ \section2 Relationship with Qt Script
- The QtWebKit bridge is similar to \l{QtScript}, especially for some of the features described in the
- \l{Making Applications Scriptable} page. However, Qt 4.7 does not provide the full QtScript API for web applications.
+ The Qt WebKit bridge is similar to \l{Qt Script}, especially for some of the features described in the
+ \l{Making Applications Scriptable} page. However, Qt 4.7 does not provide the full Qt Script API for web applications.
Full support is planned for future versions. You might notice that some of the features
described here are an exact copy of the ones described in the \l{Making Applications Scriptable} page. That is because
- the QtWebKit bridge is a subset of that functionality, and this page tries to capture the full
- capabilities available through the QtWebKit bridge specifically.
+ the Qt WebKit bridge is a subset of that functionality, and this page tries to capture the full
+ capabilities available through the Qt WebKit bridge specifically.
\section1 Accessing QObjects
@@ -74,9 +74,9 @@
\section2 Using Signals and Slots
- The QtWebKit bridge adapts Qt's central \l{Signals and Slots} feature for
+ The Qt WebKit bridge adapts Qt's central \l{Signals and Slots} feature for
scripting. There are three principal ways to use signals and slots
- with the QtWebKit bridge:
+ with the Qt WebKit bridge:
\list
\li \b{Hybrid C++/script}: C++ application code connects a
@@ -100,7 +100,7 @@
script function.
\endlist
- Note that QtScript functions such as qScriptConnect are unavilable in the web environment.
+ Note that Qt Script functions such as qScriptConnect are unavilable in the web environment.
\section3 Signal to Function Connections
@@ -117,7 +117,7 @@
\snippet webkitsnippets/qtwebkit_bridge_snippets.cpp 8
When the argument is a slot of a QObject, the argument types of the
- signal and the slot do not have to be compatible. If possible, the QtWebKit
+ signal and the slot do not have to be compatible. If possible, the Qt WebKit
bridge converts the signal arguments such that they match the slot argument.
To disconnect a slot from a signal, you call the signal's
@@ -194,7 +194,7 @@
\section3 Overloaded Signals and Slots
- When a signal or slot is overloaded, the QtWebKit bridge will attempt to
+ When a signal or slot is overloaded, the Qt WebKit bridge will attempt to
pick the right overload based on the actual types of the QScriptValue arguments
involved in the function invocation. For example, if your class has slots
\c{myOverloadedSlot(int)} and \c{myOverloadedSlot(QString)}, the following
@@ -208,7 +208,7 @@
\snippet webkitsnippets/qtwebkit_bridge_snippets.cpp 21
- If the overloads have different number of arguments, the QtWebKit bridge will
+ If the overloads have different number of arguments, the Qt WebKit bridge will
pick the overload with the argument count that best matches the
actual number of arguments passed to the slot.
@@ -260,7 +260,7 @@
When calling slots, receiving signals or accessing properties, usually some payload is involved.
For example, a property "text" might return a \l{QString} parameter.
- The QtWebKit bridge does the job of converting between a given JavaScript data-type, and the
+ The Qt WebKit bridge does the job of converting between a given JavaScript data-type, and the
expected or given Qt type. Each Qt type has a coresponding set of rules of how JavaScript treats it.
The data type conversions are also applicable for the data returned from non-void invokable methods.
@@ -269,7 +269,7 @@
All Qt numeric data types are converted to or from a JavaScript number. These include int, short, float,
double, and the portable Qt types (qreal, qint etc). A special case is \l{QChar}.
- If a slot expects a QChar, the QtWebKit bridge uses the Unicode value in case of a number and the first character in case of a string.
+ If a slot expects a QChar, the Qt WebKit bridge uses the Unicode value in case of a number and the first character in case of a string.
Note that non-standard (typedef'ed) number types are not automatically converted to
or from a JavaScript number - we suggest to use standard number types for signals, slots
@@ -280,31 +280,31 @@
\section3 Strings
- When JavaScript accesses methods or properties that expect a \l{QString}, the QtWebKit bridge
+ When JavaScript accesses methods or properties that expect a \l{QString}, the Qt WebKit bridge
will automatically convert the value to a string (if it is not already a string), using the
built-in JavaScript toString method.
- When a QString is passed to JavaScript from a signal or a property, the QtWebKit bridge
+ When a QString is passed to JavaScript from a signal or a property, the Qt WebKit bridge
converts it into a JavaScript string.
\section3 Date & Time
Both \l{QDate}, \l{QTime} and \l{QDateTime} are automatically translated to or from the JavaScript
Date object. If a number is passed as an argument to a method that expects one of the date/time
- types, the QtWebKit bridge treats it as a timestamp. If a sting is passed, QtWebKit
+ types, the Qt WebKit bridge treats it as a timestamp. If a sting is passed, Qt WebKit
tries the different Qt date parsing functions to perform the right translation.
\section3 Regular Expressions
- The QtWebKit bridge automatically converts a JavaScript RegEx object to a \l{QRegExp}.
+ The Qt WebKit bridge automatically converts a JavaScript RegEx object to a \l{QRegExp}.
If a string is passed to a method expecting a \l{QRegExp}, the string is converted
to a \l{QRegExp}.
\section3 Lists
- The QtWebKit bridge treats several types of lists in a special way: \l{QVariantList}, \l{QStringList},
+ The Qt WebKit bridge treats several types of lists in a special way: \l{QVariantList}, \l{QStringList},
\l{QObjectList} and \l{QList}<int>. When a slot or property expects one of those list types,
- the QtWebKit bridge tries to convert a JavaScript array into that type, converting each of
+ the Qt WebKit bridge tries to convert a JavaScript array into that type, converting each of
the array's elements to the single-element type of the list.
The most useful type of list is \l{QVariantList}, which can be converted to and from any
@@ -326,7 +326,7 @@
\section3 QVariants
- When a slot or property accepts a \l{QVariant}, the QtWebKit bridge creates a \l{QVariant} that best
+ When a slot or property accepts a \l{QVariant}, the Qt WebKit bridge creates a \l{QVariant} that best
matches the argument passed by JavaScript. A string, for example, becomes a \l{QVariant} holding a \l{QString},
a normal JSON object becomes a \l{QVariantMap}, and a JavaScript array becomes a \l{QVariantList}.
@@ -341,7 +341,7 @@
Pointers to a \l{QObject} or a \l{QWidget} can be used in signals, slots and properties. This object
can then be used like an object that is exposed directly. Its slots can be invoked, its signals connected to, etc.
However, this functionality is fairly limited - the type used has to be \l{QObject}* or \l{QWidget}*. If the type
- specified is a pointer to a non-\l{QWidget} subclass of \l{QObject}, the QtWebKit bridge does not recognize it as
+ specified is a pointer to a non-\l{QWidget} subclass of \l{QObject}, the Qt WebKit bridge does not recognize it as
a \l{QObject}.
In general its advised to use care when passing \l{QObject}s as arguments, as those objects don't become owned by
@@ -352,7 +352,7 @@
\since 4.7
- The QtWebKit bridge handles \l{QPixmap}s and \l{QImage}s in a special way. Since QtWebKit stores \l{QPixmap}s to
+ The Qt WebKit bridge handles \l{QPixmap}s and \l{QImage}s in a special way. Since Qt WebKit stores \l{QPixmap}s to
represent HTML images, \l{QPixmap}s coming from the native environment can be used directly inside WebKit.
A \l{QImage} or a \l{QPixmap} coming from Qt is converted to an intermediate JavaScript object,
which can be represented like this:
@@ -374,7 +374,7 @@
\snippet webkitsnippets/qtwebkit_bridge_snippets.cpp 3
When a Qt object expects a \l{QImage} or a \l{QPixmap} as input, and the argument passed is an HTML image element,
- the QtWebKit bridge would convert the pixmap assigned to that image element into a \l{QPixmap} or a \l{QImage}.
+ the Qt WebKit bridge would convert the pixmap assigned to that image element into a \l{QPixmap} or a \l{QImage}.
\since 4.7
@@ -399,7 +399,7 @@
\section2 Limiting the Scope of the Hybrid Layer
- When using QtWebKit's hybrid features, it is a common pitfall to make the API exposed to JavaScript very rich and
+ When using Qt WebKit's hybrid features, it is a common pitfall to make the API exposed to JavaScript very rich and
use all its features. This, however, leads to complexity and can create bugs that are hard to find.
Instead, it is advisable to keep the hybrid layer small and manageable: create a gate only when
there's an actual need for it, i.e. there's a new native enabler that requires a direct interface
diff --git a/Source/WebKit/qt/docs/qtwebkit-goes-mobile.qdoc b/Source/WebKit/qt/docs/qtwebkit-goes-mobile.qdoc
index 40144d18e..f1236b9c0 100644
--- a/Source/WebKit/qt/docs/qtwebkit-goes-mobile.qdoc
+++ b/Source/WebKit/qt/docs/qtwebkit-goes-mobile.qdoc
@@ -1,11 +1,11 @@
/*!
\inmodule QtWebKit
\page qtwebkit-goes-mobile.html
- \title QtWebKit Goes Mobile
- \contentspage QtWebKit
+ \title Qt WebKit Goes Mobile
+ \contentspage Qt WebKit
\section1 Overview
- A lot of effort has been put into QtWebKit to make it attractive for
+ A lot of effort has been put into Qt WebKit to make it attractive for
use on mobile devices.
The goal of this tutorial is to help you understand the mobile
@@ -24,7 +24,7 @@
Here we set up a \l{QGraphicsView} application and add a
\l{QGraphicsWebView} to the scene. Notice
- that we're disabling the scrollbars on the QGraphicsView because QtWebKit
+ that we're disabling the scrollbars on the QGraphicsView because Qt WebKit
handles scrolling and scrollbars automatically. This is to allow scrolling
optimizations and to enable web authors to interact with the scrollbars,
for instance, to style them differently.
@@ -53,7 +53,7 @@
One way to overcome this issue, is to do all loading, laying out and
painting (basically all non-UI related work) in another thread or process, and
just blit the result from the web process/thread to the UI. There is research
- in progress to enable this for a future version of QtWebKit, using WebKit2, but for now,
+ in progress to enable this for a future version of Qt WebKit, using WebKit2, but for now,
freezing the backing store can help when performing a zooming operation, for instance.
This will be discussed later, in the \l{#Enabling the Tiling}{Enabling the Tiling} section.
@@ -125,7 +125,7 @@
are written with a desktop browser in mind, that makes only very few sites
fit into the width of a mobile device.
- QtWebKit has a way to force a layout to a given width or height. What really
+ Qt WebKit has a way to force a layout to a given width or height. What really
matters here is the width. If you lay out a page to a given width, it will get
that width and images might be cropped. The width or height is also used for
laying out fixed elements, but when we resize the \l{QGraphicsWebView} to the
@@ -149,7 +149,7 @@
\section1 The 'viewport' Meta-Tag
As some sites do not work with 960 pixels width or want to have control of
- how the page is laid out, QtWebKit, Android, Firefox Mobile and
+ how the page is laid out, Qt WebKit, Android, Firefox Mobile and
the iPhone Safari browser support a meta-tag called \c viewport. This makes
it possible for a web page to let the browser know how it wants to be shown.
More info can be found in the
diff --git a/Source/WebKit/qt/docs/qtwebkit.qdoc b/Source/WebKit/qt/docs/qtwebkit.qdoc
index 7d82714c6..aa471dfc4 100644
--- a/Source/WebKit/qt/docs/qtwebkit.qdoc
+++ b/Source/WebKit/qt/docs/qtwebkit.qdoc
@@ -32,7 +32,7 @@
/*!
\page qtwebkitwidgets-index.html
- \title Qt Webkit Widgets
+ \title Qt WebKit Widgets
\ingroup modules
\brief The Qt WebKit Widgets module provides a web browser engine as well as
@@ -49,7 +49,7 @@
A bridge between the JavaScript execution environment and the Qt object
model makes it possible for custom QObjects to be scripted. For detailed
- documentation see \l{The QtWebkit Bridge}.
+ documentation see \l{The Qt WebKit Bridge}.
Integration with the Qt networking module enables Web pages to be transparently loaded
from Web servers, the local file system or even the Qt resource system.
@@ -57,7 +57,7 @@
made fully editable to the user through the use of the \c{contenteditable}
attribute on HTML elements.
- QtWebKit is based on the Open Source WebKit engine. More information about
+ Qt WebKit is based on the Open Source WebKit engine. More information about
WebKit itself can be found on the \l{WebKit Open Source Project} Web site.
\section1 Including In Your Project
@@ -74,10 +74,10 @@
\section1 Notes
- \note Building the QtWebKit module with debugging symbols is problematic
+ \note Building the Qt WebKit module with debugging symbols is problematic
on many platforms due to the size of the WebKit engine. We recommend
building the module only in release mode for embedded platforms.
- Currently QtWebKit will always be compiled without debugging symbols
+ Currently Qt WebKit will always be compiled without debugging symbols
when using gcc. Take a look at the last lines of
\c{src/3rdparty/webkit/Source/WebCore/WebCore.pro} if you need to change this.
@@ -108,7 +108,7 @@
may contain many child frames.
Individual elements of an HTML document can be accessed via DOM JavaScript
- interfaces from within a web page. The equivalent of this API in QtWebKit
+ interfaces from within a web page. The equivalent of this API in Qt WebKit
is represented by QWebElement. QWebElement objects are obtained using QWebFrame's
\l{QWebFrame::}{findAllElements()} and \l{QWebFrame::}{findFirstElement()}
functions with CSS selector queries.
@@ -193,7 +193,7 @@
can be found in the \c{src/3rdparty/webkit/VERSION} file supplied with Qt.
Qt Commercial Edition licensees that wish to distribute applications that
- use the QtWebKit module need to be aware of their obligations under the
+ use the Qt WebKit module need to be aware of their obligations under the
GNU Library General Public License (LGPL).
Developers using the Open Source Edition can choose to redistribute