summaryrefslogtreecommitdiff
path: root/sfx2/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'sfx2/README.md')
-rw-r--r--sfx2/README.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/sfx2/README.md b/sfx2/README.md
new file mode 100644
index 000000000000..9726870a6019
--- /dev/null
+++ b/sfx2/README.md
@@ -0,0 +1,28 @@
+SFX is the "old" framework, used for historical reasons.
+
+An attempt of documentation of this module is located in [git:sfx2/doc].
+
+It contains base classes for document model, view and controller, used
+by "old" applications like sw, sc, sd (while "new" applications
+are based on the "new" UNO based framework in "framework").
+
+The SFX framework is based on dispatching slots identified by integers
+(SlotIDs) to SfxShells, and there is a dedicated IDL compiler (svidl)
+involved that generates C++ slot headers from SDI files in modules' sdi/
+subdirectory.
+
+Documentation about SFX dispatch, SDI etc.:
+https://wiki.openoffice.org/wiki/Framework/Article/Implementation_of_the_Dispatch_API_In_SFX2
+
+Document load/save code is maintained in [git:sfx2/source/doc/docfile.cxx]
+SfxMedium class, which handles all the twisty load and save corner cases.
+
+[git:sfx2/source/appl/sfxhelp.cxx] Start procedure for the online
+help viewer top level window; handling of help URL creation and
+dispatch.
+
+There are also some UNO services here that could really be implemented
+anywhere, e.g. the DocumentProperties or DocumentMetadataAccess.
+
+Notable files:
+sfx2/source/dialog/backingwindow.cxx Startcenter buttons and the corresponding event handler.