~ubuntu-branches/ubuntu/saucy/lazarus/saucy

« back to all changes in this revision

Viewing changes to docs/xml/README.txt

  • Committer: Package Import Robot
  • Author(s): Paul Gevers, Abou Al Montacir, Bart Martens, Paul Gevers
  • Date: 2013-06-08 14:12:17 UTC
  • mfrom: (1.1.9)
  • Revision ID: package-import@ubuntu.com-20130608141217-7k0cy9id8ifcnutc
Tags: 1.0.8+dfsg-1
[ Abou Al Montacir ]
* New upstream major release and multiple maintenace release offering many
  fixes and new features marking a new milestone for the Lazarus development
  and its stability level.
  - The detailed list of changes can be found here:
    http://wiki.lazarus.freepascal.org/Lazarus_1.0_release_notes
    http://wiki.lazarus.freepascal.org/Lazarus_1.0_fixes_branch
* LCL changes:
  - LCL is now a normal package.
      + Platform independent parts of the LCL are now in the package LCLBase
      + LCL is automatically recompiled when switching the target platform,
        unless pre-compiled binaries for this target are already installed.
      + No impact on existing projects.
      + Linker options needed by LCL are no more added to projects that do
        not use the LCL package.
  - Minor changes in LCL basic classes behaviour
      + TCustomForm.Create raises an exception if a form resource is not
        found.
      + TNotebook and TPage: a new implementation of these classes was added.
      + TDBNavigator: It is now possible to have focusable buttons by setting
        Options = [navFocusableButtons] and TabStop = True, useful for
        accessibility and for devices with neither mouse nor touch screen.
      + Names of TControlBorderSpacing.GetSideSpace and GetSpace were swapped
        and are now consistent. GetSideSpace = Around + GetSpace.
      + TForm.WindowState=wsFullscreen was added
      + TCanvas.TextFitInfo was added to calculate how many characters will
        fit into a specified Width. Useful for word-wrapping calculations.
      + TControl.GetColorResolvingParent and
        TControl.GetRGBColorResolvingParent were added, simplifying the work
        to obtain the final color of the control while resolving clDefault
        and the ParentColor.
      + LCLIntf.GetTextExtentExPoint now has a good default implementation
        which works in any platform not providing a specific implementation.
        However, Widgetset specific implementation is better, when available.
      + TTabControl was reorganized. Now it has the correct class hierarchy
        and inherits from TCustomTabControl as it should.
  - New unit in the LCL:
      + lazdialogs.pas: adds non-native versions of various native dialogs,
        for example TLazOpenDialog, TLazSaveDialog, TLazSelectDirectoryDialog.
        It is used by widgetsets which either do not have a native dialog, or
        do not wish to use it because it is limited. These dialogs can also be
        used by user applications directly.
      + lazdeviceapis.pas: offers an interface to more hardware devices such
        as the accelerometer, GPS, etc. See LazDeviceAPIs
      + lazcanvas.pas: provides a TFPImageCanvas descendent implementing
        drawing in a LCL-compatible way, but 100% in Pascal.
      + lazregions.pas. LazRegions is a wholly Pascal implementation of
        regions for canvas clipping, event clipping, finding in which control
        of a region tree one an event should reach, for drawing polygons, etc.
      + customdrawncontrols.pas, customdrawndrawers.pas,
        customdrawn_common.pas, customdrawn_android.pas and
        customdrawn_winxp.pas: are the Lazarus Custom Drawn Controls -controls
        which imitate the standard LCL ones, but with the difference that they
        are non-native and support skinning.
  - New APIs added to the LCL to improve support of accessibility software
    such as screen readers.
* IDE changes:
  - Many improvments.
  - The detailed list of changes can be found here:
    http://wiki.lazarus.freepascal.org/New_IDE_features_since#v1.0_.282012-08-29.29
    http://wiki.lazarus.freepascal.org/Lazarus_1.0_release_notes#IDE_Changes
* Debugger / Editor changes:
  - Added pascal sources and breakpoints to the disassembler
  - Added threads dialog.
* Components changes:
  - TAChart: many fixes and new features
  - CodeTool: support Delphi style generics and new syntax extensions.
  - AggPas: removed to honor free licencing. (Closes: Bug#708695)
[Bart Martens]
* New debian/watch file fixing issues with upstream RC release.
[Abou Al Montacir]
* Avoid changing files in .pc hidden directory, these are used by quilt for
  internal purpose and could lead to surprises during build.
[Paul Gevers]
* Updated get-orig-source target and it compinion script orig-tar.sh so that they
  repack the source file, allowing bug 708695 to be fixed.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
The lcl directory contains the fpdoc xml files for the lcl. For example
4
4
lcl/controls.xml for controls.pp.
5
5
 
 
6
You can create new entries with the fpdoc editor of the IDE (View / FPDoc Editor).
 
7
 
6
8
--------------------------------------------------------------------------------
7
 
They were created with:
 
9
You can create xml files for new units with the IDE fpdoc editor or with:
8
10
perl multi_makeskel.pl -p lcl -s ../../lcl -o lcl \
9
11
  -i '-Fi/path/to/lazarus/lcl/include' -x
10
12
  
11
13
At the moment the fpdoc tool 'makeskel' is not yet capable of updating the
12
 
files. But this will follow in a few weeks.
13
 
 
14
 
--------------------------------------------------------------------------------
15
 
Finding the new files, not yet in CVS (probably obsolete now):
16
 
 
17
 
perl find_cvs_fpdoc_files.pl -s ../../lcl -o lcl -l new
18
 
 
19
 
--------------------------------------------------------------------------------
20
 
Finding old the files in CVS not needed any more (probably obsolete now):
21
 
 
22
 
perl find_cvs_fpdoc_files.pl -s ../../lcl -o lcl -l old
 
14
files.
23
15
 
24
16
--------------------------------------------------------------------------------
25
17
If you don't have perl installed, you can use the following command to update
30
22
To create a new file use:
31
23
makeskel --package=lcl --input="..\..\lcl\forms.pp" --output=lcl\forms.xml
32
24
 
 
25
See also: StyleGuide.txt
 
26
 
33
27
--------------------------------------------------------------------------------
34
28
Examples for gtk interface:
35
29
 
36
30
Creation:
37
 
perl multi_makeskel.pl -p gtk -s ../../lcl/interfaces/gtk \
 
31
perl multi_makeskel.pl -p lclgtk -s ../../lcl/interfaces/gtk \
38
32
  -o lcl/interfaces/gtk -i '-Fi/path/to/lazarus/lcl/interfaces/gtk' -x
39
33
 
40
 
Finding the new files, not yet in CVS:
41
 
perl find_cvs_fpdoc_files.pl -s ../../lcl/interfaces/gtk \
42
 
  -o lcl/interfaces/gtk -l new
43
 
 
44
 
Finding old the files in CVS not needed any more:
45
 
perl find_cvs_fpdoc_files.pl -s ../../lcl/interfaces/gtk \
46
 
  -o lcl/interfaces/gtk -l old
47
34
  
48
35