don't make read-only text controls editable when enabled

[wxWidgets.git] / docs / latex / wx / portnote.tex

diff --git a/docs/latex/wx/portnote.tex b/docs/latex/wx/portnote.tex
index e42b9ee73d278e44ced0b727d07cf2f687c60814..3e71a18bdb8387e225f78abafdc2d21196691caf 100644 (file)
--- a/docs/latex/wx/portnote.tex
+++ b/docs/latex/wx/portnote.tex
@@ -1,13 +1,33 @@
-\chapter{Port notes}\label{portnotes}
+\chapter{Platform details}\label{platformdetails}
 \setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
 \setfooter{\thepage}{}{}{}{}{\thepage}%
 
-This chapter contains port specific notes.
+wxWidgets defines a common API across platforms, but uses the native graphical
+user interface (GUI) on each platform, so your program will take on the native
+look and feel that users are familiar with. Unfortunately native toolkits and
+hardware do not always support the functionality that the wxWidgets API
+requires. This chapter collects notes about differences among supported platforms and ports.
 
 \input wxgtk.tex
 \input wxmsw.tex
 \input wxmac.tex
+\input wxpalm.tex
 \input wxos2.tex
 \input wxmgl.tex
 \input wxx11.tex
 
+\subsection{Documentation for the native toolkits}\label{nativedocs}
+
+It's sometimes useful to interface directly with the underlying toolkit
+used by wxWidgets to e.g. use toolkit-specific features.
+In such case (or when you want to e.g. write a port-specific patch) it can be
+necessary to use the underlying toolkit API directly:
+
+\begin{description}\itemsep=0pt
+\item[{\bf wxMSW}]
+wxMSW port uses win32 API: \urlref{MSDN docs}{http://msdn2.microsoft.com/en-us/library/ms649779.aspx}
+
+\item[{\bf wxGTK}]
+wxGTK port uses GTK+: \urlref{GTK+ 2.x docs}{http://developer.gnome.org/doc/API/2.0/gtk/index.html}
+
+\end{description}
\ No newline at end of file