style: improve doc notes

Author: ryanio

packages/vm/lib/runCall.ts

@@ -18,7 +18,7 @@ export interface RunCallOpts {
   value?: BN
   data?: Buffer
   /**
-   * This is for CALLCODE where the code to load is different than the code from the to account
+   * This is for CALLCODE where the code to load is different than the code from the `opts.to` address.
    */
   code?: Buffer
   depth?: number

packages/vm/lib/runCode.ts

@@ -4,12 +4,12 @@ This is the core of the Ethereum Virtual Machine (EVM or just VM).
 
 NOTES:
 
-stack items are lazily duplicated.
-So you must never directly change a buffer from the stack,
-instead you should `copy` it first
+1. Stack items are lazily duplicated, so you must never directly change a buffer
+from the stack, instead you should `copy` it first.
+
+2. Not all stack items are 32 bytes, so if the operation relies on the stack
+item length then you must use `utils.pad(<item>, 32)` first.
 
-not all stack items are 32 bytes, so if the operation relies on the stack
-item length then you must use utils.pad(<item>, 32) first.
 */
 import { Address, BN } from 'ethereumjs-util'
 import { Block } from '@ethereumjs/block'
@@ -23,7 +23,7 @@ import { default as EVM, ExecResult } from './evm/evm'
  */
 export interface RunCodeOpts {
   /**
-   * The [`Block`](https://github.com/ethereumjs/ethereumjs-block) the `tx` belongs to. If omitted a blank block will be used
+   * The `@ethereumjs/block` the `tx` belongs to. If omitted a default blank block will be used.
    */
   block?: Block
   evm?: EVM

packages/vm/lib/runTx.ts

@@ -12,11 +12,11 @@ import TxContext from './evm/txContext'
  */
 export interface RunTxOpts {
   /**
-   * The block to which the `tx` belongs
+   * The `@ethereumjs/block` the `tx` belongs to. If omitted a default blank block will be used.
    */
   block?: Block
   /**
-   * An [`@ethereumjs/tx`](https://github.com/ethereumjs/ethereumjs-vm/tree/master/packages/tx) to run
+   * An `@ethereumjs/tx` to run
    */
   tx: Transaction
   /**