From 2bd457291839342ef19d343e2410e206fe1f3dd7 Mon Sep 17 00:00:00 2001 From: Albrecht Schlosser Date: Sun, 7 Dec 2008 17:01:55 +0000 Subject: Fixed typos and amended doxygen docs. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6562 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- src/fl_dnd_mac.cxx | 6 +++--- src/fl_dnd_win32.cxx | 17 ++++++++++------- src/fl_draw.cxx | 12 +++++++----- 3 files changed, 20 insertions(+), 15 deletions(-) (limited to 'src') diff --git a/src/fl_dnd_mac.cxx b/src/fl_dnd_mac.cxx index 68dcb6cfe..19d7a6865 100644 --- a/src/fl_dnd_mac.cxx +++ b/src/fl_dnd_mac.cxx @@ -22,8 +22,8 @@ // // Please report all bugs and problems to "fltk-bugs@fltk.org -// This file contains win32-specific code for fltk which is always linked -// in. Search other files for "WIN32" or filenames ending in _win32.cxx +// This file contains MacOS-specific code for fltk which is always linked +// in. Search other files for "__APPLE__" or filenames ending in _mac.cxx // for other system-specific code. #include @@ -32,7 +32,7 @@ #include // warning: this function is only implemented in Quickdraw. The function -// below may not work If FLTK is compiled with Quartz enabled +// below may not work if FLTK is compiled with Quartz enabled extern EventRef fl_os_event; extern char *fl_selection_buffer; diff --git a/src/fl_dnd_win32.cxx b/src/fl_dnd_win32.cxx index 092c598eb..26fd47bb4 100644 --- a/src/fl_dnd_win32.cxx +++ b/src/fl_dnd_win32.cxx @@ -383,9 +383,10 @@ public: /** - * this is the actual object that FLTK can drop somewhere - * - the implementation is minimal, but it should work with all decent Win32 drop targets - */ + This is the actual object that FLTK can drop somewhere. + + The implementation is minimal, but it should work with all decent Win32 drop targets +*/ class FLDataObject : public IDataObject { DWORD m_cRefCount; @@ -484,10 +485,12 @@ public: /** - * drag and drop whatever is in the cut-copy-paste buffer - * - create a selection first using: - * Fl::copy(const char *stuff, int len, 0) - */ + Drag and drop whatever is in the cut-copy-paste buffer. + + Create a selection first using: + + Fl::copy(const char *stuff, int len, 0) +*/ int Fl::dnd() { DWORD dropEffect; diff --git a/src/fl_draw.cxx b/src/fl_draw.cxx index cbdc2cc7d..b074258eb 100644 --- a/src/fl_draw.cxx +++ b/src/fl_draw.cxx @@ -102,10 +102,11 @@ static bool handle_utf8_seq(const char * &s,char * &d) { } /** - Copy \a from to \a buf, replacing unprintable characters with ^X and \\nnn + Copy \a from to \a buf, replacing unprintable characters with ^X and \\nnn. + Stop at a newline or if MAXBUF characters written to buffer. Also word-wrap if width exceeds maxw. - Returns a pointer to the start of the next line of caharcters. + Returns a pointer to the start of the next line of characters. Sets n to the number of characters put into the buffer. Sets width to the width of the string in the current font. */ @@ -177,7 +178,7 @@ fl_expand_text(const char* from, char* buf, int maxbuf, double maxw, int& n, /** The same as fl_draw(const char*,int,int,int,int,Fl_Align,Fl_Image*,int) with - the addition of the \a callthis parameter, which is a pointer to text drawing + the addition of the \a callthis parameter, which is a pointer to a text drawing function such as fl_draw(const char*, int, int, int) to do the real work */ void fl_draw( @@ -328,11 +329,12 @@ void fl_draw( /** Fancy string drawing function which is used to draw all the labels. + The string is formatted and aligned inside the passed box. - Handles '\\t' and '\\n', exapands all other control characters to '^X', + Handles '\\t' and '\\n', expands all other control characters to '^X', and aligns inside or against the edges of the box. See Fl_Widget::align() for values of \a align. The value FL_ALIGN_INSIDE - is ignored, as this functon always prints inside the box. + is ignored, as this function always prints inside the box. If \a img is provided and is not \a NULL, the image is drawn above or below the text as specified by the \a align value. The \a draw_symbols argument specifies whether or not to look for symbol -- cgit v1.2.3