From fd9ac19838b4d97262a7c4411d80c2d64e54d653 Mon Sep 17 00:00:00 2001 From: Chris Sherlock Date: Fri, 23 Jun 2017 08:42:42 +1000 Subject: osl: w32/file.cxx update comments Change-Id: I837db449b4e1eb16580bbfd57647f6372b43e4d8 Reviewed-on: https://gerrit.libreoffice.org/39143 Tested-by: Jenkins Reviewed-by: Noel Grandin --- sal/osl/w32/file.cxx | 24 ++++++++++-------------- 1 file changed, 10 insertions(+), 14 deletions(-) (limited to 'sal') diff --git a/sal/osl/w32/file.cxx b/sal/osl/w32/file.cxx index 207c18c7eaef..cb4d2e5e8bab 100644 --- a/sal/osl/w32/file.cxx +++ b/sal/osl/w32/file.cxx @@ -43,8 +43,8 @@ #undef min #endif -// File handle implementation - +/** File handle implementation. +*/ struct FileHandle_Impl { CRITICAL_SECTION m_mutex; @@ -54,19 +54,19 @@ struct FileHandle_Impl */ enum StateBits { - STATE_SEEKABLE = 1, /* open() sets, iff regular file */ - STATE_READABLE = 2, /* open() sets, read() requires */ - STATE_WRITEABLE = 4, /* open() sets, write() requires */ + STATE_SEEKABLE = 1, /*< open() sets, iff regular file */ + STATE_READABLE = 2, /*< open() sets, read() requires */ + STATE_WRITEABLE = 4, /*< open() sets, write() requires */ STATE_MODIFIED = 8 /* write() sets, flush() resets */ }; int m_state; - sal_uInt64 m_size; /* file size */ - LONGLONG m_offset; /* physical offset from begin of file */ - LONGLONG m_filepos; /* logical offset from begin of file */ + sal_uInt64 m_size; /*< file size */ + LONGLONG m_offset; /*< physical offset from begin of file */ + LONGLONG m_filepos; /*< logical offset from begin of file */ - LONGLONG m_bufptr; /* buffer offset from begin of file */ - SIZE_T m_buflen; /* buffer filled [0, m_bufsiz - 1] */ + LONGLONG m_bufptr; /*< buffer offset from begin of file */ + SIZE_T m_buflen; /*< buffer filled [0, m_bufsiz - 1] */ SIZE_T m_bufsiz; sal_uInt8 * m_buffer; @@ -664,8 +664,6 @@ oslFileError FileHandle_Impl::syncFile() return result; } -// File I/O functions - extern "C" oslFileHandle SAL_CALL osl_createFileHandleFromOSHandle ( HANDLE hFile, @@ -1090,8 +1088,6 @@ SAL_CALL osl_setFileSize (oslFileHandle Handle, sal_uInt64 uSize) return pImpl->setSize (uSize); } -// File handling functions - oslFileError SAL_CALL osl_removeFile( rtl_uString* strPath ) { rtl_uString *strSysPath = nullptr; -- cgit