C-Hglib/Questions

Through time I had received lots of question about C-hglib project.

I made this page to counter those question and to have them in a single place.

Initial commit mail (http://markmail.org/thread/ism45s5vp7jsbp5u):

1. hg_handle* hg_open(const char *path, char *encoding, char *configs);

   • More const. Misplaced *. What is configs?
2. What if we want to run a command without a repository, like init or clone?

3. int hg_rawcommand(hg_handle *handle, const char *command);

   • How do we pass args with spaces?
4. How do we get exit codes?
5. How do we send input to a command like 'hg import -'?
6. How do we handle interactive commands like merge?
7. How do we get error output and warnings?

C-hglib – Level 0 , API proposal mail (http://mercurial.markmail.org/thread/f5irmijzatlephtw):

8. What does this return? ( The return values for all API functions )

9. int hg_close(hg_handle *handle);
   /* The function returns 0 if successful,
    * -1 to indicate an error, with errno set appropriately. */

   • What sorts of errors might we encounter?
10. Story for :

    1. hg init <- doesn't start with a repo

       b. hg log <- can produce huge output

       c. hg import - <- wants a patch fed to it from client

       d. hg merge <- has prompts

       e. hg verify <- might give warnings intermixed with output

11. Do you see the * on the left? ( pointer issue)
12. How do I set encoding for the connection?
13. Will this do the right thing? If so, how?(adding file with space issue)
14. How do I get the prompt questions displayed to the user and get the user answers back?
15. Limiting the amount of data sounds sensible, but why write it to a file? What about a cursor-like interface, similar to those returned by SQL queries?

Header patchbomb mail (http://mercurial.markmail.org/thread/qsfwzmxzzs4ekuuv):

16. Action-header, what is an action-header ?
17. so wpipe is server stdin, rpipe is server stdout. Were have stderr been?
18. "The repository in which I am", do you mean the first repository found in PWD hierarchy?
19. What is the default encoding?