From ae515a346ca6422750b985a68975fb4bd9de7be9 Mon Sep 17 00:00:00 2001
From: Roberto Ierusalimschy <roberto@inf.puc-rio.br>
Date: Wed, 28 Oct 2015 10:25:36 -0200
Subject: [PATCH] comments for luaD_precall/luaD_poscall

---
 ldo.c | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/ldo.c b/ldo.c
index 123c1194..564bacd4 100644
--- a/ldo.c
+++ b/ldo.c
@@ -1,5 +1,5 @@
 /*
-** $Id: ldo.c,v 2.141 2015/10/21 18:40:47 roberto Exp roberto $
+** $Id: ldo.c,v 2.142 2015/10/28 12:06:45 roberto Exp roberto $
 ** Stack and Call structure of Lua
 ** See Copyright Notice in lua.h
 */
@@ -315,8 +315,13 @@ static void tryfuncTM (lua_State *L, StkId func) {
     luaC_checkGC(L),  /* stack grow uses memory */ \
     p = restorestack(L, t__))  /* 'pos' part: restore 'p' */
 
+
 /*
-** returns true if function has been executed (C function)
+** Prepares a function call: checks the stack, creates a new CallInfo
+** entry, fills in the relevant information, calls hook if needed.
+** If function is a C function, does the call, too. (Otherwise, leave
+** the execution ('luaV_execute') to the caller, to allow stackless
+** calls.) Returns true iff function has been executed (C function).
 */
 int luaD_precall (lua_State *L, StkId func, int nresults) {
   lua_CFunction f;
@@ -381,6 +386,11 @@ int luaD_precall (lua_State *L, StkId func, int nresults) {
 }
 
 
+/*
+** Finishes a function call: calls hook if necessary, removes CallInfo,
+** moves corrent number of results to proper place; returns 0 iff call
+** wanted multiple (variable number of) results.
+*/
 int luaD_poscall (lua_State *L, StkId firstResult, int nres) {
   StkId res;
   int wanted, i;