[11.x] Add @throws to some doc blocks

[saMahmoudzadeh]

change 1:

/**
   * Throw an HttpException with the given data.
   *
   * @param  \Symfony\Component\HttpFoundation\Response|\Illuminate\Contracts\Support\Responsable|int  $code
   * @param  string  $message
   * @param  array  $headers
   * @return never
   *
   * @throws \Symfony\Component\HttpKernel\Exception\HttpException
   * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
   * @throws \Illuminate\Http\Exceptions\HttpResponseException
   */
function abort($code, $message = '', array $headers = [])
{
    if ($code instanceof Response) {
        throw new HttpResponseException($code);
    } elseif ($code instanceof Responsable) {
        throw new HttpResponseException($code->toResponse(request()));  // ==> add `@throw` to doc block
    }

    app()->abort($code, $message, $headers);
}

change 2:

/**
  * Create a new file download response.
  *
  * @param  \SplFileInfo|string  $file
  * @param  string|null  $name
  * @param  array  $headers
  * @param  string|null  $disposition
  * @return \Symfony\Component\HttpFoundation\BinaryFileResponse
  */
public function streamDownload($callback, $name = null, array $headers = [], $disposition = 'attachment')
{
  $withWrappedException = function () use ($callback) {
      try {
          $callback();
      } catch (Throwable $e) {
          throw new StreamedResponseException($e);  // ==> add `@throw` to doc block
      }
  };

 ..................

[github-actions]

Thanks for submitting a PR!

Note that draft PR's are not reviewed. If you would like a review, please mark your pull request as ready for review in the GitHub user interface.

Pull requests that are abandoned in draft may be closed due to inactivity.