Commit Graph

53 Commits

Author SHA1 Message Date
oneeyeman1
14bcf09924 Move URL<->filename conversion functions to wxFileName
This ensures that they are always available and can be used in
wxLaunchDefaultBrowser() in all build variants, whereas before this
function didn't handle file:// URLs correctly when the library was built
with wxUSE_FILESYSTEM==0.

Closes https://github.com/wxWidgets/wxWidgets/pull/1469

Closes #10414.
2019-08-25 00:48:39 +02:00
Scott Talbert
c68e5d0617 Fix some spelling/grammar errors in documentation
Mostly replace ungrammatical "allows to do" with correct "allows doing".

Closes https://github.com/wxWidgets/wxWidgets/pull/1183
2019-01-26 03:50:47 +01:00
Tobias Taschner
85bbcff9cc Remove wxOSX/Carbon only wxFileName methods from docs.
The carbon only implementation was removed in 5ba67c67e4.
2016-02-23 13:15:07 +01:00
Catalin
71ad2d64ef Remove obsolete symbols and platforms from the documentation
Don't mention pre-XP Windows versions and other obsolete platforms such as
OS/2 and the symbols which were only useful for them.

Closes https://github.com/wxWidgets/wxWidgets/pull/137
2015-12-03 22:05:55 +01:00
Catalin
2a882b2bb3 Mention that temp dir is for current user. 2015-08-08 17:57:21 +03:00
Vadim Zeitlin
9b31387508 Merge the changes from 3.0 branch.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@75178 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-11-12 18:06:37 +00:00
Václav Slavík
ac3bf36958 Replace @since 2.9.6 with 3.0 in the docs.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74742 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-09-02 12:17:06 +00:00
Vadim Zeitlin
5bd6ad08a7 Add wxFileName::SetPermissions().
This is a simple wrapper for the POSIX chmod().

Closes #12951.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74639 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-08-07 11:08:28 +00:00
Vadim Zeitlin
3f66f6a5b3 Remove all lines containing cvs/svn "$Id$" keyword.
This keyword is not expanded by Git which means it's not replaced with the
correct revision value in the releases made using git-based scripts and it's
confusing to have lines with unexpanded "$Id$" in the released files. As
expanding them with Git is not that simple (it could be done with git archive
and export-subst attribute) and there are not many benefits in having them in
the first place, just remove all these lines.

If nothing else, this will make an eventual transition to Git simpler.

Closes #14487.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-07-26 16:02:46 +00:00
Vadim Zeitlin
2d5efafe74 Disable test for setting the creation time under Unix.
Also document that this doesn't work there.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74424 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-07-06 19:14:20 +00:00
Vadim Zeitlin
6aa4e3989f Return false from wxFileName::AppendDir() and InsertDir() on failure.
Give the caller a way to know whether the directory was valid or not.

Closes #15091.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@73631 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2013-03-09 15:08:36 +00:00
Vadim Zeitlin
58263bb4c3 Make wxFILE_EXISTS_SYMLINK work on its own, without wxFILE_EXISTS_NO_FOLLOW.
Include the wxFILE_EXISTS_NO_FOLLOW bit in wxFILE_EXISTS_SYMLINK definition to
allow using just wxFileName::Exists(wxFILE_EXISTS_SYMLINK) which used to never
work because the link was followed.

Closes #14777.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72777 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-10-25 22:30:43 +00:00
Vadim Zeitlin
0f57172b93 Mention wxFILE_EXISTS_NO_FOLLOW in wxFILE_EXISTS_SYMLINK description.
Using wxFILE_EXISTS_SYMLINK without wxFILE_EXISTS_NO_FOLLOW can only be
fruitless, so mention that they should normally be used together in the
documentation.

An alternative solution would be to always add wxFILE_EXISTS_NO_FOLLOW
automatically if wxFILE_EXISTS_SYMLINK is used, perhaps we should do this
instead.

See #14542.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72741 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-10-23 23:57:54 +00:00
Vadim Zeitlin
c50db84779 Allow testing for existence of specific file types in wxFileName.
Add "flags" parameter to wxFileName::Exists() to allow testing for the
existing of files of specific type: not only regular or directory but also
symlink, device, FIFO or socket.

And also to pass wxFILE_EXISTS_NO_FOLLOW flag inhibiting following the
symlinks without using DontFollowLink().

Closes #14542.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72707 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-10-19 22:02:15 +00:00
Vadim Zeitlin
c063adebba Add support for symlinks to wxFileName.
Allow to work with the symlinks themselves and not the file they reference by
calling the new wxFileName::DontFollowLink().

Update Unix wxDir implementation to not treat symlinks to directories as
directories, this ensures that we don't recurse into the directories outside
of the original parent accidentally.

Closes #14542.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72680 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-10-15 01:09:01 +00:00
Vadim Zeitlin
7740f1c7c9 Uncomment and improve wxFileName::CreateTempFileName() documentation.
Most of CreateTempFileName() documentation was commented out in r57994 for
some reason, uncomment it back and also improve it.

Closes #14545.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@72269 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-07-31 16:49:42 +00:00
Vadim Zeitlin
996d3fe3f8 Added wxFileName::Exists().
This function checks for existence of anything with the given name, not
necessarily just a file or a directory.

Extend the unit test to verify that it returns true for /dev/null on Unix
systems.

Closes #953.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@70600 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-02-15 15:39:46 +00:00
Vadim Zeitlin
ccca2121ef Document Mac-only wxFileName methods as being Mac-only.
Use @onlyfor for them for consistency and to help the automated code
generators.

Closes #13971.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@70587 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2012-02-15 00:35:36 +00:00
Vadim Zeitlin
824216af78 Correct wxFileName::SetPath() documentation.
It wrongly claimed that this function affected the full path, i.e. including
name and extension, which was simply wrong.

Closes #13612.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@69618 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2011-10-31 19:33:43 +00:00
Václav Slavík
76ba33d39a Clarify that wxFileName::GetPath() appends separator for toplevel dirs.
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@67723 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2011-05-10 09:58:52 +00:00
Dimitri Schoolwerth
d13b34d3f2 No code changes, fixed various typos.
Applied patch by snowleopard2 fixing typos in interface/. Extended the fixes throughout trunk.

Closes #13076.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@67384 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2011-04-03 20:31:32 +00:00
Dimitri Schoolwerth
e02edc0e6e Fixed typo in wxFileName::GetHumanReadableSize docs.
Closes #12898.



git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@66757 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2011-01-25 08:15:55 +00:00
Vadim Zeitlin
fcf56ee4de Warn that normalizing a valid path may make it invalid sometimes.
Mention the special case of a path without file name and with directory that
normalizes to empty string.

See #10960.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@66255 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-11-24 12:43:45 +00:00
Vadim Zeitlin
526954c596 Globally use "wxWindows licence" consistently.
Use "wxWindows licence" and not "wxWidgets licence" (the latter doesn't
exist) and consistently spell "licence" using British spelling.

See #12165.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@64940 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-07-13 13:29:13 +00:00
Francesco Montorsi
d38315df30 Remove identic implementations of wxDir::Exists from platform-specific files and put it in dircmn.cpp (they all used wxDirExists).
Add wxDir::Make() and wxDir::Remove() for coherency with wxDir::Exists() and document them as simple aliases to wxFileName functions, just a bit more readable.


git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@64632 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-06-19 11:07:16 +00:00
Vadim Zeitlin
72822505f7 Correct documentation of wxSizeConvention elements.
1KiB is 1024 bytes, not 1000. Also put the elements in the correct order (same
as in the real header).

See #10673.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@63890 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-04-07 10:50:37 +00:00
Francesco Montorsi
2febffbac7 fix typos introduced by error in r63870 (see #10673)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@63886 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-04-06 22:51:11 +00:00
Vadim Zeitlin
b2edb8f3c5 Add support for IEC and SI size units to wxFileName::GetHumanReadableSize().
Allow choosing the multiplier to use (1000 or 1024) and the names of the units
(SI or IEC). By default, still use traditional convention, i.e. multiplier of
1024 but SI unit names. This will probably need to be changed to use IEC units
in the future.

Also added unit test for this function.

Closes #10673.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@63870 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2010-04-06 14:53:04 +00:00
Vadim Zeitlin
e01a788ee0 Add support for MSW unique volume names to wxFileName.
Recognize the paths starting with "\\?\Volume{GUID}" under MSW and provide a
way to test for them.

Closes #8874.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@62782 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-12-05 17:31:00 +00:00
Vadim Zeitlin
cb755cb737 Document wxFileName::SetPath().
Closes #11162.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@61827 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-09-04 16:20:49 +00:00
Vadim Zeitlin
31eacdaf44 Correct wxPATH_NORM_DOTS comment and documentation.
It doesn't prepend the current working directory, only wxPATH_NORM_ABSOLUTE does.

Closes #11035.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@61578 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-08-02 01:03:00 +00:00
Vadim Zeitlin
d9e80dce15 make more wxFileName methods const (closes #10887)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@61022 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-06-12 15:28:45 +00:00
Vadim Zeitlin
89391a4ea1 make wxFileName::{Mk,Rm}dir() const (closes #10868)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@61002 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-06-11 16:11:07 +00:00
Vadim Zeitlin
181dd701fa implement deprecated wxStripExtension() in terms of new wxFileName::StripExtension() (closes #10634)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@59868 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-03-26 15:55:01 +00:00
Vadim Zeitlin
110c50944f added wxPATH_RMDIR_FULL/RECURSIVE wxFileName::Rmdir() flags (closes #10422)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@58385 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-25 12:37:16 +00:00
Francesco Montorsi
882678ebb4 other ifacecheck fixes
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57994 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-10 23:44:44 +00:00
Francesco Montorsi
382f12e419 many automated ifacecheck fixes
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57992 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-10 22:42:09 +00:00
Francesco Montorsi
395f3aa8bd rewrite wxContractPath as wxFileName::ReplaceEnvVariable and wxFileName::ReplaceHomeDir; add test units and docs for them
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57867 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-07 00:38:46 +00:00
Francesco Montorsi
eadd3970f2 better docs for wxPathNormalize
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57866 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-07 00:17:10 +00:00
Francesco Montorsi
992ff3310e use doxygen autolink for global enumerations
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57843 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2009-01-05 18:24:05 +00:00
Robert Roebling
f95032cab9 Correct AssignTempFile docs
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@57426 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-12-18 21:26:34 +00:00
Francesco Montorsi
920b92a3fd few other fixes for wxChar => wxString
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56889 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-11-22 10:41:52 +00:00
Francesco Montorsi
a44f3b5a89 ifacecheck manual fixes
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56720 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-11-09 16:46:52 +00:00
Francesco Montorsi
76e9224eb2 fix for doxygen warnings
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@56084 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-10-04 20:49:51 +00:00
Francesco Montorsi
b91c4601f2 many ifacecheck automatic fixes + some access-specifier manual fix
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@55942 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-09-29 10:52:37 +00:00
Francesco Montorsi
adaaa68635 HUGE commit of ifacecheck-automated fixes to virtualness/constness/staticness of wxWidgets documented functions
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@55912 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-09-27 11:21:10 +00:00
Francesco Montorsi
f41d6c8cd7 add wxPosixPermissions enumeration; it provides more readable synonims for wxS_I* flags and makes it easier to document which flags can be used in wxFile functions and wxFileName::Mkdir (and in future wxFileName::Chmod)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@55908 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-09-27 10:27:44 +00:00
Francesco Montorsi
0b70c946a3 more f*h interface file revisions
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@55890 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-09-25 19:15:28 +00:00
Vadim Zeitlin
35c2aa4f19 added wxFileName::GetVolumeString() (#9950)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@55596 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-09-14 01:18:05 +00:00
Robert Roebling
2bd5625855 Further corrections to wxFileName docs
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54807 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2008-07-29 13:08:30 +00:00