Changeset 49 for trunk/src/IDocument.cxx

Show
Ignore:
Timestamp:
04/13/06 05:47:01 (3 years ago)
Author:
jordi
Message:

Added the doxygen documentation builder file in the "doc" directory. I've also wirtten the missing documentation for all files in "src", but not in "src/gtk" a it would be redundant.

Also I've been paranoic on spelling (I'm a very bad spelled) and spell checked all source files, changing some string. Updated the translations.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • trunk/src/IDocument.cxx

    r45 r49  
    3636 
    3737/// 
    38 /// @brief Gets the Document's error quark. 
     38/// @brief Gets the IDocument's error quark. 
    3939/// 
    4040/// The first time it's called will create the new quark value for the  
     
    4242/// quark value. 
    4343/// 
    44 /// @return The Document's quark. 
     44/// The error quark is used by Glib's g_set_error() function to set the  
     45/// domain in that the error happened. EPDFVIEW_DOCUMENT_ERROR has been 
     46/// defined to call this function, use that defined string when using 
     47/// g_set_error() inside a document's class. 
     48/// 
     49/// @return The IDocument's quark. 
    4550/// 
    4651GQuark 
     
    114119 
    115120/// 
    116 /// @brief Constructs a new Document object. 
     121/// @brief Constructs a new IDocument object. 
    117122/// 
    118123IDocument::IDocument () 
     
    139144 
    140145/// 
    141 /// @brief Deletes all dynamically created objects of Document. 
     146/// @brief Deletes all dynamically created objects of IDocument. 
    142147/// 
    143148IDocument::~IDocument () 
     
    215220/// @brief Gets the document's subject. 
    216221/// 
    217 /// @return The subject of the document or an empty string ig the document don't 
     222/// @return The subject of the document or an empty string if the document don't 
    218223///         have subject. 
    219224/// 
     
    243248/// @brief Gets the document's keywords. 
    244249/// 
    245 /// @return An string with all keywords separated by whitespace, or an empty 
     250/// @return An string with all keywords separated by white space, or an empty 
    246251///         string if the document have no keywords. 
    247252/// 
     
    259264/// @brief Sets the document's keywords. 
    260265/// 
    261 /// @param keywords A whitespace separated list of keywords. 
     266/// @param keywords A white space separated list of keywords. 
    262267/// 
    263268void 
     
    326331/// @brief Gets the document's format. 
    327332/// 
    328 /// @returns The PDF version of the document or an empty string if the version 
     333/// @returns The version of the document or an empty string if the version 
    329334///          is not available (usually only when the document has not been 
    330335///          loaded yet). 
     
    341346 
    342347/// 
    343 /// @brief Sets the document format. 
     348/// @brief Sets the document's format. 
    344349/// 
    345350/// @param format Set the format in which the document is. 
     
    353358 
    354359/// 
    355 /// @brief Gets if the document is linearized. 
    356 /// 
    357 /// @return The string "Yes" if the document is optimized for web viewing, "No" 
    358 ///         if it's not optimized or an empty string if this information is 
     360/// @brief Gets if the document is linearised. 
     361/// 
     362/// @return The string "Yes" if the document is optimised for web viewing, "No" 
     363///         if it's not optimised or an empty string if this information is 
    359364///         not available. 
    360365/// 
     
    370375 
    371376/// 
    372 /// @brief Sets if the document is linearized. 
     377/// @brief Sets if the document is linearised. 
    373378/// 
    374379/// @param linearized Set to TRUE if the document is linearized.  
    375 ///                   False otherwise. 
     380///                   FALSE otherwise. 
    376381/// 
    377382void 
     
    513518/// 
    514519/// @return The file name that contains the document, or an empty string 
    515 ///         if the document isn't loeaded yet. 
     520///         if the document isn't loaded yet. 
    516521/// 
    517522const gchar * 
     
    533538IDocument::setFileName (const gchar *fileName) 
    534539{ 
    535     g_assert (NULL != fileName && "Tried to set a NULL filename."); 
     540    g_assert (NULL != fileName && "Tried to set a NULL file name."); 
    536541 
    537542    g_free (m_FileName); 
     
    605610/// Changes the current page to be the page @a pageNum. If @a pageNum is 
    606611/// greater than the document's last page, then the current page becomes 
    607 /// the last page. If @pageNum is instead less then the first page (i.e.,  
     612/// the last page. If @a pageNum is instead less then the first page (i.e.,  
    608613/// <= 0) then the current page becomes the first (i.e., 1). 
    609614/// 
     
    651656/// @brief Rotates 90 to the left. 
    652657/// 
    653 /// Substract 90 degress to the document's rotation. 
     658/// Substract 90 degrees to the document's rotation. 
    654659/// 
    655660void 
     
    666671/// @brief Rotates 90 to the right. 
    667672/// 
    668 /// Adds 90 degress to the document's rotation. 
     673/// Adds 90 degrees to the document's rotation. 
    669674/// 
    670675void 
     
    677682/// @brief Checks if is possible to zoom in. 
    678683/// 
    679 /// Checks if after zooming int the zoom level will be below the max level. 
     684/// Checks if after zooming in the zoom level will be below the max level. 
    680685/// 
    681686gboolean 
     
    688693/// @brief Checks if is possible to zoom out. 
    689694/// 
    690 /// Checks if after zoomin out the zoom level will be above the min level. 
     695/// Checks if after zooming out the zoom level will be above the min level. 
    691696/// 
    692697gboolean 
     
    710715/// @brief Zooms In. 
    711716/// 
    712 /// Adds a fixed ammount to the scale / zoom level. 
     717/// Adds a fixed amount to the scale / zoom level if the zoom level has not 
     718/// reached the max. 
     719/// 
     720/// @see canZoomIn() 
    713721/// 
    714722void 
     
    724732/// @brief Zooms Out. 
    725733/// 
    726 /// Substracts a fixed amount to the scale / zoom level. 
     734/// Substracts a fixed amount to the scale / zoom level is the zoom level 
     735/// has not reached the min. 
     736/// 
     737/// @see canZoomOut() 
    727738/// 
    728739void 
     
    761772/// @brief Zooms the document to fit the width. 
    762773/// 
    763 /// It tries to get the best zooms / sclale level that will let the document 
    764 /// fit into @a width, wihtout looking into any height. 
     774/// It tries to get the best zooms / scale level that will let the document 
     775/// fit into @a width, without looking into any height. 
    765776/// 
    766777/// @param width The width to fit the document to.