From 452dbef3dcc27f46d3b7316a5573d2ce907b993c Mon Sep 17 00:00:00 2001
From: Yoichi Hirai <i@yoichihirai.com>
Date: Mon, 21 Nov 2016 15:47:04 +0100
Subject: [PATCH] docs: add a section about calldata layout

Part of #1390
---
 docs/miscellaneous.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/docs/miscellaneous.rst b/docs/miscellaneous.rst
index 0b3eed38e..15ff374d2 100644
--- a/docs/miscellaneous.rst
+++ b/docs/miscellaneous.rst
@@ -74,6 +74,17 @@ Solidity always places new objects at the free memory pointer and memory is neve
 
 .. index: memory layout
 
+*******************
+Layout of Call Data
+*******************
+
+When a Solidity contract is deployed and when it is called from an
+account, the input data is assumed to be in the format in `the ABI
+specification
+<https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABI>`_.  The
+ABI specification requires arguments to be padded to multiples of 32
+bytes.  The internal function calls use a different convention.
+
 *****************
 Esoteric Features
 *****************