DOC-4997 fixed misleading header advice

Author: andy-stark-redis

content/develop/clients/hiredis/_index.md

@@ -30,8 +30,6 @@ Then, in a terminal, go into the `hiredis` folder and run the `make` command to
 the dynamically-loaded library for `hiredis` (this has the name `libhiredis.dylib` on
 MacOS and `libhiredis.so` on Linux). You can copy this library to your
 project folder or run `sudo make install` to install it to `/usr/local/lib`.
-You should also copy the header files `hiredis.h`, `alloc.h`, `read.h`, and
-`sds.h` to your project.
 
 ## Connect and test
 
@@ -43,7 +41,7 @@ connection. An explanation of the code follows the example.
 ```c
 #include <stdio.h>
 
-#include "hiredis.h"
+#include <hiredis/hiredis.h>
 
 int main() {
     // The `redisContext` type represents the connection
@@ -81,8 +79,9 @@ int main() {
 
 For a real project, you would build your code with a makefile, but for
 this simple test, you can just place it in a file called `main.c` and
-build it with the following command (assuming you used `make install` to
-install the `libhiredis` library):
+build it with the following command. (If you didn't install `hiredis`
+using `make install`, then you should also use the `-I` option to
+specify the folder that contains the `hiredis` headers.)
 
 ```bash
 cc main.c -L/usr/local/lib -lhiredis
@@ -123,11 +122,7 @@ to prevent errors.
 The [`hiredis`](https://github.com/redis/hiredis) Github repository contains
 examples and details that may be useful if you are using `hiredis` to
 implement a higher-level client for another programming language. There are
-also examples showing how to use `hiredis` from a
-[C++ application](https://github.com/redis/hiredis/blob/master/examples/example-qt.cpp)
-created with [Qt](https://www.qt.io/) and how to use the
-[asynchronous API](https://github.com/redis/hiredis?tab=readme-ov-file#asynchronous-api)
-with the [libev](https://software.schmorp.de/pkg/libev.html) and
-[libevent](https://libevent.org/) libraries.
+also examples showing how to use `hiredis` adapter headers to integrate with
+various event handling frameworks.
 
 See the other pages in this section for more information and examples.

content/develop/clients/hiredis/connect.md

@@ -25,7 +25,7 @@ and port as its arguments, and returns a context object.
 ```c
 #include <stdio.h>
 
-#include "hiredis.h"
+#include <hiredis/hiredis.h>
     .
     .
     .
@@ -72,13 +72,14 @@ It lets you supply callbacks to respond when a connection is successful
 or to handle any errors that may occur.
 
 The following code creates an asynchronous connection and
-sets the context callbacks:
+sets the context callbacks. Note that you must also include the
+`async.h` header to access the asynchronous API.
 
 ```c
 #include <stdio.h>
 
-#include "hiredis.h"
-#include "async.h"
+#include <hiredis/hiredis.h>
+#include <hiredis/async.h>
     .
     .
     .

content/develop/clients/hiredis/int-examples/libevent-integration.md

@@ -44,16 +44,6 @@ cc main.c -L/usr/local/lib -lhiredis -levent
 See [Build and install]({{< relref "/develop/clients/hiredis#build-and-install" >}})
 to learn how to build `hiredis`, if you have not already done so.
 
-Add the following header files from the `hiredis` folder to your project folder:
-
--   `hiredis.h`
--   `async.h`
--   `adapters/libevent.h`
-
-You should include the `libevent.h` file in a folder called `adapters` but you
-don't need the other headers in the original `adapters` folder for this
-example.
-
 Now, add the following code in `main.c`. An explanation follows the
 code example:
 
@@ -63,9 +53,9 @@ code example:
 #include <string.h>
 #include <signal.h>
 
-#include "hiredis.h"
-#include "async.h"
-#include "adapters/libevent.h"
+#include <hiredis/hiredis.h>
+#include <hiredis/async.h>
+#include <hiredis/adapters/libevent.h>
 
 // Callback for the `GET` command. 
 void getCallback(redisAsyncContext *c, void *r, void *privdata) {

content/develop/clients/hiredis/int-examples/qt-integration.md

@@ -42,30 +42,7 @@ it doesn't do anything useful at this stage.
 
 Build `hiredis` if you have not already done so (see
 [Build and install]({{< relref "/develop/clients/hiredis#build-and-install" >}})
-for more information). Copy the following files from the `hiredis` folder into
-the Header files section of your Qt project:
-
-- `hiredis.h`
-- `async.h`
-- `alloc.h`
-- `read.h`
-- `sds.h`
-- `adapters/qt.h`
-
-In `qt.h`, edit the line near the top of the file that reads
-
-```c
-#include "../async.h"
-```
-
-to
-
-```c
-#include "async.h"
-```
-
-You must do this because `qt.h` is in the same enclosing folder as `async.h` for
-this project.
+for more information).
 
 You should also make the `libhiredis` library available to the project. For example,
 if you have used the default option of [`cmake`](https://cmake.org/) as the project
@@ -106,9 +83,9 @@ An explanation follows the code.
 
 #include <QObject>
 
-#include "hiredis.h"
-#include "async.h"
-#include "qt.h"
+#include <hiredis/hiredis.h>
+#include <hiredis/async.h>
+#include <hiredis/adapters/qt.h>
 
 
 class RedisExample : public QObject

content/develop/clients/hiredis/issue-commands.md

@@ -122,6 +122,10 @@ Use the `redisAsyncCommand()` and `redisAsyncCommandArgv()`
 functions to send commands to the server asynchronously:
 
 ```c
+#include <hiredis/async.h>
+    .
+    .
+    .
 int redisAsyncCommand(
   redisAsyncContext *ac, redisCallbackFn *fn, void *privdata,
   const char *format, ...);