Yet another cleanup
Fix PHPdoc in apps/files_sharing

using scrutinizer patch
Fix PHPdoc in OC\Share\Share and OCP\Share
Fix linkToPublic. Refs #8218
Also fix linkToAbsolute
Add tests for linkTo, linkToPublic, linkToRemote, linkToRemoteBase
Remove unused var
Permit personal mount points to be used for sharing

An issue existed where `readData` used `OCP\User::getUser()` to get the user
for personal mount points, which worked in all situations apart from when a
personal mount point was used for sharing, so the return from `getUser()` is
not the user that owns the share. As such, any personal mount points would not
work correctly when shared.

`readData` and `writeData` have been changed from using a `$isPersonal`
boolean to using a `$user` string|null. `$isPersonal = false` can now be
written as `$user = NULL` (or left out in the case of `readData`), and
`$isPersonal = true` can be written as `$user = OCP\User::getUser()`.
Merge branch 'master' into type-hinting-sharing

Conflicts:
	apps/files_sharing/lib/share/file.php
	apps/files_sharing/tests/api.php
	lib/private/share/share.php
Some more params are optional
Better documentation for isValidSource function
Correct return type for getFilePath
Typo
[tx-robot] updated from transifex
fix folder icon (file had a big background rectangle before)
Some expected Sabre exceptions are now logged with DEBUG level
ignore part files
check if we have a fileinfo
Merge pull request #8489 from owncloud/share_updater_ignore_part_files

[sharing] share updater ignore part files
Merge pull request #8223 from owncloud/fix_linkToPublic

Fix linkToPublic and linkToAbsolute.