| Index: trunk/phase3/includes/filerepo/backend/FileBackend.php |
| — | — | @@ -406,7 +406,7 @@ |
| 407 | 407 | * Callers should consider using getScopedFileLocks() instead. |
| 408 | 408 | * |
| 409 | 409 | * @param $paths Array Storage paths |
| 410 | | - * @param $type integer LockManager::LOCK_EX, LockManager::LOCK_SH |
| | 410 | + * @param $type integer LockManager::LOCK_* constant |
| 411 | 411 | * @return Status |
| 412 | 412 | */ |
| 413 | 413 | final public function lockFiles( array $paths, $type ) { |
| — | — | @@ -417,7 +417,7 @@ |
| 418 | 418 | * Unlock the files at the given storage paths in the backend. |
| 419 | 419 | * |
| 420 | 420 | * @param $paths Array Storage paths |
| 421 | | - * @param $type integer LockManager::LOCK_EX, LockManager::LOCK_SH |
| | 421 | + * @param $type integer LockManager::LOCK_* constant |
| 422 | 422 | * @return Status |
| 423 | 423 | */ |
| 424 | 424 | final public function unlockFiles( array $paths, $type ) { |
| — | — | @@ -433,7 +433,7 @@ |
| 434 | 434 | * the status updated. Unlock fatals will not change the status "OK" value. |
| 435 | 435 | * |
| 436 | 436 | * @param $paths Array Storage paths |
| 437 | | - * @param $type integer LockManager::LOCK_EX, LockManager::LOCK_SH |
| | 437 | + * @param $type integer LockManager::LOCK_* constant |
| 438 | 438 | * @param $status Status Status to update on lock/unlock |
| 439 | 439 | * @return ScopedLock|null Returns null on failure |
| 440 | 440 | */ |
| — | — | @@ -460,7 +460,7 @@ |
| 461 | 461 | * $params include: |
| 462 | 462 | * src : source path on disk |
| 463 | 463 | * dst : destination storage path |
| 464 | | - * overwriteDest : do nothing and pass if an identical file exists at destination |
| | 464 | + * overwriteDest : overwrite any file that exists at the destination |
| 465 | 465 | * |
| 466 | 466 | * @param $params Array |
| 467 | 467 | * @return Status |
| — | — | @@ -482,7 +482,7 @@ |
| 483 | 483 | * $params include: |
| 484 | 484 | * src : source storage path |
| 485 | 485 | * dst : destination storage path |
| 486 | | - * overwriteDest : do nothing and pass if an identical file exists at destination |
| | 486 | + * overwriteDest : overwrite any file that exists at the destination |
| 487 | 487 | * |
| 488 | 488 | * @param $params Array |
| 489 | 489 | * @return Status |
| — | — | @@ -502,7 +502,8 @@ |
| 503 | 503 | * Delete a file at the storage path. |
| 504 | 504 | * Do not call this function from places outside FileBackend and FileOp. |
| 505 | 505 | * $params include: |
| 506 | | - * src : source storage path |
| | 506 | + * src : source storage path |
| | 507 | + * ignoreMissingSource : do nothing if the source file does not exist |
| 507 | 508 | * |
| 508 | 509 | * @param $params Array |
| 509 | 510 | * @return Status |
| — | — | @@ -524,7 +525,7 @@ |
| 525 | 526 | * $params include: |
| 526 | 527 | * src : source storage path |
| 527 | 528 | * dst : destination storage path |
| 528 | | - * overwriteDest : do nothing and pass if an identical file exists at destination |
| | 529 | + * overwriteDest : overwrite any file that exists at the destination |
| 529 | 530 | * |
| 530 | 531 | * @param $params Array |
| 531 | 532 | * @return Status |
| — | — | @@ -556,7 +557,7 @@ |
| 557 | 558 | * $params include: |
| 558 | 559 | * srcs : ordered source storage paths (e.g. chunk1, chunk2, ...) |
| 559 | 560 | * dst : destination storage path |
| 560 | | - * overwriteDest : do nothing and pass if an identical file exists at destination |
| | 561 | + * overwriteDest : overwrite any file that exists at the destination |
| 561 | 562 | * |
| 562 | 563 | * @param $params Array |
| 563 | 564 | * @return Status |
| — | — | @@ -578,7 +579,7 @@ |
| 579 | 580 | * $params include: |
| 580 | 581 | * content : the raw file contents |
| 581 | 582 | * dst : destination storage path |
| 582 | | - * overwriteDest : do nothing and pass if an identical file exists at destination |
| | 583 | + * overwriteDest : overwrite any file that exists at the destination |
| 583 | 584 | * |
| 584 | 585 | * @param $params Array |
| 585 | 586 | * @return Status |