8000 Update filesystem.rst by flip111 · Pull Request #8323 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Update filesystem.rst #8323

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 3 commits into from
Closed

Update filesystem.rst #8323

wants to merge 3 commits into from

Conversation

flip111
Copy link
Contributor
@flip111 flip111 commented Aug 30, 2017

add information about umask to directory creation

add information about umask to directory creation
@flip111
Copy link
Contributor Author
flip111 commented Aug 30, 2017

Don't know what wrong with the build

/home/travis/build/symfony/symfony-docs/components/filesystem.rst:73: ERROR: Unknown target name: "umask<https://en.wikipedia.org/wiki/umask/>".

was following http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#embedded-uris-and-aliases

@@ -68,6 +68,10 @@ On POSIX filesystems, directories are created with a default mode value

This function ignores already existing directories.

.. note::

The directory permissions are affected by the current `umask<https://en.wikipedia.org/wiki/Umask/>`_.. Set the umask for your webserver, use PHP's `umask() function<https://secure.php.net/umask>`_. or use the chmod() function after the directory has been created.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are few things to change here, but overall this looks good. Can you update the paragraph to something like this:

.. note::

    The directory permissions are affected by the current `umask`_. Set
    the umask for your webserver, use PHP's :phpfunction:`umask` function
    or use the :phpfunction:`chmod` function after the directory has been
    created.

You then need to add the link target at the end of the document:

.. _`umask`: https://en.wikipedia.org/wiki/Umask

@@ -68,6 +68,10 @@ On POSIX filesystems, directories are created with a default mode value

This function ignores already existing directories.

.. note::

The directory permissions are affected by the current `umask`_. Set the umask for your webserver, use PHP's :phpfunction:`umask` function or use the :phpfunction:`chmod` function after the directory has been created.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please also wrap all lines after the first word that crosses the 72nd character.

@xabbuh xabbuh added this to the 2.7 milestone Aug 31, 2017
Added line wrap at char 72
@xabbuh
Copy link
Member
xabbuh commented Sep 1, 2017

Thank you @flip111.

xabbuh added a commit that referenced this pull request Sep 1, 2017
This PR was squashed before being merged into the 2.7 branch (closes #8323).

Discussion
----------

Update filesystem.rst

add information about umask to directory creation

Commits
-------

a472f32 Update filesystem.rst
@xabbuh xabbuh closed this Sep 1, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants
0