[8.17](backport #42306) x-pack/filebeat/docs - document gzip S3 object handling

[mergify]

Proposed commit message

Document how compressed objects are handled by the aws-s3 input.

---

This is an automatic backport of pull request #42306 done by [Mergify](https://mergify.com).

[mergify]

Cherry-pick of 7fd2d46 has failed:

On branch mergify/bp/8.17/pr-42306
Your branch is up to date with 'origin/8.17'.

You are currently cherry-picking commit 7fd2d46de.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   x-pack/filebeat/docs/inputs/input-aws-s3.asciidoc

no changes added to commit (use "git add" and/or "git commit -a")

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

[botelastic]

This pull request doesn't have a Team:<team> label.

[mergify]

This pull request has not been merged yet. Could you please review and merge it @andrewkroh? 🙏