Issue #2599250 by krknth: Fixing order of documentation sections

core/modules/book/src/BookExport.php

@@ -65,12 +65,12 @@ public function __construct(EntityManagerInterface $entityManager, BookManagerIn
    * @param \Drupal\node\NodeInterface $node
    *   The node to export.
    *
-   * @throws \Exception
-   *   Thrown when the node was not attached to a book.
-   *
    * @return array
    *   A render array representing the HTML for a node and its children in the
    *   book hierarchy.
+   *
+   * @throws \Exception
+   *   Thrown when the node was not attached to a book.
    */
   public function bookExportHtml(NodeInterface $node) {
     if (!isset($node->book)) {

core/modules/comment/src/Controller/CommentController.php

@@ -113,11 +113,11 @@ public function commentApprove(CommentInterface $comment) {
    * @param \Drupal\comment\CommentInterface $comment
    *   A comment entity.
    *
-   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
-   * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
-   *
    * @return \Symfony\Component\HttpFoundation\Response
    *   The comment listing set to the page on which the comment appears.
+   *
+   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
+   * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
    */
   public function commentPermalink(Request $request, CommentInterface $comment) {
     if ($entity = $comment->getCommentedEntity()) {
@@ -172,10 +172,10 @@ public function commentPermalinkTitle(CommentInterface $comment) {
    * @param \Drupal\Core\Entity\EntityInterface $node
    *   The node object identified by the legacy URL.
    *
-   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
-   *
    * @return \Symfony\Component\HttpFoundation\RedirectResponse
    *   Redirects user to new url.
+   *
+   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    */
   public function redirectNode(EntityInterface $node) {
     $fields = $this->commentManager->getFields('node');
@@ -208,13 +208,14 @@ public function redirectNode(EntityInterface $node) {
    *   (optional) Some comments are replies to other comments. In those cases,
    *   $pid is the parent comment's comment ID. Defaults to NULL.
    *
-   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    * @return array|\Symfony\Component\HttpFoundation\RedirectResponse
    *   An associative array containing:
    *   - An array for rendering the entity or parent comment.
    *     - comment_entity: If the comment is a reply to the entity.
    *     - comment_parent: If the comment is a reply to another comment.
    *   - comment_form: The comment form as a renderable array.
+   *
+   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    */
   public function getReplyForm(Request $request, EntityInterface $entity, $field_name, $pid = NULL) {
     $account = $this->currentUser();
@@ -270,9 +271,10 @@ public function getReplyForm(Request $request, EntityInterface $entity, $field_n
    *   (optional) Some comments are replies to other comments. In those cases,
    *   $pid is the parent comment's comment ID. Defaults to NULL.
    *
-   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    * @return \Drupal\Core\Access\AccessResultInterface
    *   An access result
+   *
+   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    */
   public function replyFormAccess(EntityInterface $entity, $field_name, $pid = NULL) {
     // Check if entity and field exists.
@@ -312,10 +314,11 @@ public function replyFormAccess(EntityInterface $entity, $field_name, $pid = NUL
    * @param \Symfony\Component\HttpFoundation\Request $request
    *   The request of the page.
    *
-   * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
-   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    * @return \Symfony\Component\HttpFoundation\JsonResponse
    *   The JSON response.
+   *
+   * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
+   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    */
   public function renderNewCommentsNodeLinks(Request $request) {
     if ($this->currentUser()->isAnonymous()) {

core/modules/image/src/Controller/ImageStyleDownloadController.php

@@ -85,13 +85,13 @@ public static function create(ContainerInterface $container) {
    * @param \Drupal\image\ImageStyleInterface $image_style
    *   The image style to deliver.
    *
+   * @return \Symfony\Component\HttpFoundation\BinaryFileResponse|\Symfony\Component\HttpFoundation\Response
+   *   The transferred file as response or some error response.
+   *
    * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
    *   Thrown when the user does not have access to the file.
    * @throws \Symfony\Component\HttpKernel\Exception\ServiceUnavailableHttpException
    *   Thrown when the file is still being generated.
-   *
-   * @return \Symfony\Component\HttpFoundation\BinaryFileResponse|\Symfony\Component\HttpFoundation\Response
-   *   The transferred file as response or some error response.
    */
   public function deliver(Request $request, $scheme, ImageStyleInterface $image_style) {
     $target = $request->query->get('file');

core/modules/system/src/FileDownloadController.php

@@ -35,13 +35,13 @@ class FileDownloadController extends ControllerBase {
    * @param string $scheme
    *   The file scheme, defaults to 'private'.
    *
+   * @return \Symfony\Component\HttpFoundation\BinaryFileResponse
+   *   The transferred file as response.
+   *
    * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
    *   Thrown when the requested file does not exist.
    * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
    *   Thrown when the user does not have access to the file.
-   *
-   * @return \Symfony\Component\HttpFoundation\BinaryFileResponse
-   *   The transferred file as response.
    */
   public function download(Request $request, $scheme = 'private') {
     $target = $request->query->get('file');

core/modules/views/src/ViewExecutable.php

@@ -1855,11 +1855,11 @@ public function getUrl($args = NULL, $display_id = NULL) {
    * @param string $display_id
    *   (Optional) The display id. ( Used only to detail an exception. )
    *
-   * @throws \InvalidArgumentException
-   *   Thrown when the display plugin does not have a URL to return.
-   *
    * @return \Drupal\Core\Url
    *   The display handlers URL object.
+   *
+   * @throws \InvalidArgumentException
+   *   Thrown when the display plugin does not have a URL to return.
    */
   public function getUrlInfo($display_id = '') {
     $this->initDisplay();